InputNumber 数字输入
uni-appH5微信小程序App
跨端数字输入器,支持步进、边界和精度控制。
何时使用
需要输入有范围/步长约束的数值:数量、价格、评分档位。
何时不使用
纯文本或自由格式输入用 Input;范围选择且无需精确值用 Slider。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | number | null | null | 绑定值(v-model) |
min | number | "-Infinity" | 最小值,超出时钳制 |
max | number | "Infinity" | 最大值,超出时钳制 |
step | number | 1 | 步进按钮的步长 |
precision | number | - | 小数位数,传入后值按此修正并格式化 |
disabled | boolean | false | 禁用 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | number | null | 值变化时触发(步进或输入提交) |
change | number | null | 值提交时触发(步进、失焦或回车解析后) |
示例
基础用法
vue
<InputNumber v-model="num1" />步长与范围
vue
<InputNumber v-model="num2" :min="0" :max="10" :step="2" />禁用
vue
<InputNumber v-model="num1" disabled />尺寸
vue
<view class="row">
<InputNumber v-model="num1" size="sm" />
<InputNumber v-model="num2" size="lg" />
</view>