element/examples/docs/zh-CN/input-number.md
baiyaaaaa 258a165416 add name prop to form components (#6042)
add name prop

Revert "feature menu collapse"

This reverts commit e5ef11d87825f02357c434aedfcef79192600b1b.
2017-07-30 16:26:05 +08:00

3.3 KiB

InputNumber 计数器

仅允许输入标准的数字值,可定义范围

基础用法

:::demo 要使用它,只需要在el-input-number元素中使用v-model绑定变量即可,变量的初始值即为默认值。

<template>
  <el-input-number v-model="num1" @change="handleChange" :min="1" :max="10"></el-input-number>
</template>
<script>
  export default {
    data() {
      return {
        num1: 1
      };
    },
    methods: {
      handleChange(value) {
        console.log(value);
      }
    }
  };
</script>

:::

禁用状态

:::demo disabled属性接受一个Boolean,设置为true即可禁用整个组件,如果你只需要控制数值在某一范围内,可以设置min属性和max属性,不设置minmax时,最小值为 0。

<template>
  <el-input-number v-model="num2" :disabled="true"></el-input-number>
</template>
<script>
  export default {
    data() {
      return {
        num2: 1
      }
    }
  };
</script>

:::

步数

允许定义递增递减的步数控制

:::demo 设置step属性可以控制步长,接受一个Number

<template>
  <el-input-number v-model="num3" :step="2"></el-input-number>
</template>
<script>
  export default {
    data() {
      return {
        num3: 5
      }
    }
  };
</script>

:::

尺寸

额外提供了 largesmall 两种尺寸的数字输入框

:::demo

<template>
  <el-input-number size="large" v-model="num4"></el-input-number>
  <el-input-number v-model="num5"></el-input-number>
  <el-input-number size="small" v-model="num6"></el-input-number>
</template>
<script>
  export default {
    data() {
      return {
        num4: 1,
        num5: 1,
        num6: 1
      }
    }
  };
</script>

:::

Attributes

参数 说明 类型 可选值 默认值
value 绑定值 number
min 设置计数器允许的最小值 number 0
max 设置计数器允许的最大值 number Infinity
step 计数器步长 number 1
size 计数器尺寸 string large, small
disabled 是否禁用计数器 boolean false
controls 是否使用控制按钮 boolean true
debounce 输入时的去抖延迟,毫秒 number 300
name 原生属性 string

Events

事件名称 说明 回调参数
change 绑定值被改变时触发 最后变更的值
blur 在组件 Input 失去焦点时触发 (event: Event)
focus 在组件 Input 获得焦点时触发 (event: Event)

Methods

方法名 说明 参数
focus 使 input 获取焦点 -