InputNumber 计数器

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

基础用法

InputNumber 计数器 - 图1

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

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

禁用状态

InputNumber 计数器 - 图2

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

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

步数

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

InputNumber 计数器 - 图3

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

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

严格步数

InputNumber 计数器 - 图4

step-strictly属性接受一个Boolean。如果这个属性被设置为true,则只能输入步数的倍数。

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

精度

InputNumber 计数器 - 图5

设置 precision 属性可以控制数值精度,接收一个 Number

<template>
  <el-input-number v-model="num" :precision="2" :step="0.1" :max="10"></el-input-number>
</template>
<script>
  export default {
    data() {
      return {
        num: 1
      }
    }
  };
</script>

precision 的值必须是一个非负整数,并且不能小于 step 的小数位数。

尺寸

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

InputNumber 计数器 - 图6

<template>
  <el-input-number v-model="num1"></el-input-number>
  <el-input-number size="medium" v-model="num2"></el-input-number>
  <el-input-number size="small" v-model="num3"></el-input-number>
  <el-input-number size="mini" v-model="num4"></el-input-number>
</template>
<script>
  export default {
    data() {
      return {
        num1: 1,
        num2: 1,
        num3: 1,
        num4: 1
      }
    }
  };
</script>

按钮位置

InputNumber 计数器 - 图7

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

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

Attributes

参数说明类型可选值默认值
value / v-model绑定值number0
min设置计数器允许的最小值number-Infinity
max设置计数器允许的最大值numberInfinity
step计数器步长number1
step-strictly是否只能输入 step 的倍数numberfalse
precision数值精度number
size计数器尺寸stringlarge, small
disabled是否禁用计数器booleanfalse
controls是否使用控制按钮booleantrue
controls-position控制按钮位置stringright-
name原生属性string
label输入框关联的label文字string
placeholder输入框默认 placeholderstring--

Events

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

Methods

方法名说明参数
focus使 input 获取焦点-
select选中 input 中的文字