InputNumber 计数器

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

基础用法

基础用法.png

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

  1. <template>
  2. <el-input-number v-model="num1" @change="handleChange" :min="1" :max="10" label="描述文字"></el-input-number>
  3. </template>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. num1: 1
  9. };
  10. },
  11. methods: {
  12. handleChange(value) {
  13. console.log(value);
  14. }
  15. }
  16. };
  17. </script>

禁用状态

禁用状态.png

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

  1. <template>
  2. <el-input-number v-model="num2" :disabled="true"></el-input-number>
  3. </template>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. num2: 1
  9. }
  10. }
  11. };
  12. </script>

步数

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

步数.png

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

  1. <template>
  2. <el-input-number v-model="num3" :step="2"></el-input-number>
  3. </template>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. num3: 5
  9. }
  10. }
  11. };
  12. </script>

尺寸

额外提供了 mediumsmallmini 三种尺寸的数字输入框
尺寸.png

  1. <template>
  2. <el-input-number v-model="num4"></el-input-number>
  3. <el-input-number size="medium" v-model="num5"></el-input-number>
  4. <el-input-number size="small" v-model="num6"></el-input-number>
  5. <el-input-number size="mini" v-model="num7"></el-input-number>
  6. </template>
  7. <script>
  8. export default {
  9. data() {
  10. return {
  11. num4: 1,
  12. num5: 1,
  13. num6: 1,
  14. num7: 1
  15. }
  16. }
  17. };
  18. </script>

按钮位置

按钮位置.png

设置 controls-position 属性可以控制按钮位置。

  1. <template>
  2. <el-input-number v-model="num8" controls-position="right" @change="handleChange" :min="1" :max="10"></el-input-number>
  3. </template>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. num8: 1
  9. };
  10. },
  11. methods: {
  12. handleChange(value) {
  13. console.log(value);
  14. }
  15. }
  16. };
  17. </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
controls-position 控制按钮位置 string right -
name 原生属性 string
label 输入框关联的label文字 string

Events

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

Methods

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