跳到主要内容

InputNumber 数字输入 ​

uni-appH5微信小程序App

跨端数字输入器,支持步进、边界和精度控制。

何时使用 ​

需要输入有范围/步长约束的数值:数量、价格、评分档位。

何时不使用 ​

纯文本或自由格式输入用 Input;范围选择且无需精确值用 Slider。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
InputNumber 数字输入 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValuenumber | nullnull绑定值(v-model)
minnumber"-Infinity"最小值,超出时钳制
maxnumber"Infinity"最大值,超出时钳制
stepnumber1步进按钮的步长
precisionnumber-小数位数,传入后值按此修正并格式化
disabledbooleanfalse禁用
sizestring:'sm' | 'md' | 'lg'"md"尺寸

Events ​

名称载荷说明
update:modelValuenumber | null值变化时触发(步进或输入提交)
changenumber | 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>