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 控制每次点击增减的跨度,设置 min 与 max 控制允许的上下限数值范围。
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 | 是否开启键盘直接手动输入 | Boolean | true | false | false |
| decimal | 保留的小数点位数 | Number | - | 0 |
| disabled | 是否禁用加减交互 | Boolean | true | false | false |
事件说明 (Events)
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | 数值发生改变时触发 | (value: Number) |
| update:modelValue | 数值发生改变时触发 (双向绑定) | (value: Number) |
| update:value | 数值发生改变时触发 (value 写法兼容) | (value: Number) |