计数器（form-input-number）

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

基础用法

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

<template>
  <itv-form>
    <itv-form-input-number label="数量" v-model="num" @change="handleChange" :min="1" :max="10" clearable></itv-form-input-number>
  </itv-form>
</template>
<script>
  export default {
    data() {
      return {
        num: 1
      };
    },
    methods: {
      handleChange(value) {
        console.log(value);
      }
    }
  };
</script>

Expand Copy Copy

禁用状态

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

<template>
  <itv-form>
    <itv-form-input-number label="数量" v-model="num" disabled></itv-form-input-number>
  </itv-form>
</template>
<script>
  export default {
    data() {
      return {
        num: 1
      }
    }
  };
</script>

Expand Copy Copy

步数

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

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

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

Expand Copy Copy

类型

允许设置设置integer, float类型，float支持设置digits长度

设置 type 属性可以设置integer, float 。

<template>
  <itv-form>
    <itv-form-input-number label="数量" type="integer" v-model="num1"></itv-form-input-number>
    <itv-form-input-number label="数量" type="float" v-model="num2"></itv-form-input-number>
  </itv-form>
</template>
<script>
  export default {
    data() {
      return {
        num1: 5,
        num2: 5
      }
    }
  };
</script>

Expand Copy Copy

精度

设置 digits 属性可以控制数值精度。

<template>
  <itv-form>
    <itv-form-input-number label="数量" type="float" digits="4" v-model="num"></itv-form-input-number>
  </itv-form>
</template>
<script>
  export default {
    data() {
      return {
        num: 1
      }
    }
  };
</script>

Expand Copy Copy

尺寸

额外提供了 medium 、 small 、 mini 三种尺寸的数字输入框

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

Expand Copy Copy

Attributes

TIP

默认继承FormItem基础属性FormItem组件。

参数	说明	类型	可选值	默认值
value / v-model	绑定值	number	—	0
type	类型	string	integer, float	integer
min	设置计数器允许的最小值	number，string	—	-Infinity
max	设置计数器允许的最大值	number，string	—	Infinity
step	计数器步长	number，string	—	1
digits	只对 type=float 有效，小数位数	number，string	—	2
size	计数器尺寸	string	large, small	—
disabled	是否禁用计数器	boolean	—	false
readonly	是否只读	boolean	—	false
clearable	当有值时，是否在右侧显示清除按钮	boolean	—	false
controls	只对 type=number，integer，float 有效，是否显示控制按钮	boolean	—	true
placeholder	输入框默认 placeholder	string	-	-

Events

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

Methods

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