Skip to content

InputNumber 步进器

用于控制数值加减调节的步进计数器控件,常用于电商购物车商品数量增减、参数微调与范围数值限定。


代码示例

1. 基础用法 (Basic)

使用 v-model 绑定当前数值,默认步长为 1。

vue
<template>
  <mu-input-number v-model="count" :min="1" :max="10" />
</template>

<script setup>
import { ref } from 'vue'
const count = ref(1)
</script>

2. 步长与上下限限制 (Step & Limits)

设置 step 控制每次点击增减的跨度,设置 minmax 控制允许的上下限数值范围。

vue
<template>
  <mu-input-number v-model="value" :step="5" :min="0" :max="100" />
</template>

3. 直接键盘输入 (Editable)

设置 editable 允许用户点击中间数字弹出数字键盘进行手动直接修改。

vue
<template>
  <mu-input-number v-model="value" editable :min="1" :max="999" />
</template>

4. 保留小数精度 (Decimal)

设置 decimal 属性指定计算后的浮点小数保留位数(如 decimal="2")。

vue
<template>
  <mu-input-number v-model="price" :step="0.5" :decimal="2" :min="0" :max="10" />
</template>

5. 禁用状态 (Disabled)

设置 disabled 禁止用户点击与修改。

vue
<template>
  <mu-input-number v-model="count" disabled />
</template>

API 属性说明 (Props)

参数名说明类型可选值默认值
v-model当前绑定的数值 (同 value)Number | String-1
min允许输入的最小值Number-0
max允许输入的最大值Number-9999
step每次加减的步长Number-1
editable是否开启键盘直接手动输入Booleantrue | falsefalse
decimal保留的小数点位数Number-0
disabled是否禁用加减交互Booleantrue | falsefalse

事件说明 (Events)

事件名说明回调参数
change数值发生改变时触发(value: Number)
update:modelValue数值发生改变时触发 (双向绑定)(value: Number)
update:value数值发生改变时触发 (value 写法兼容)(value: Number)

基于 MIT 协议开源发行

H5 模拟器 (input-number)☀️🔄