跳到主要内容

InputNumber 数字输入 ​

WebH5

数字输入框。左右步进按钮增减,支持 min/max 钳制、precision 小数位与长按连续步进。

何时使用 ​

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

何时不使用 ​

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

Props ​

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

Events ​

名称载荷说明
update:modelValuenumber | null值变化时触发(步进或输入提交)
changenumber | null值提交时触发(步进、失焦或回车解析后)

示例 ​

基础 ​

示例加载中…

金额与精度 ​

示例加载中…

尺寸与禁用 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 InputNumber 文档(含手机预览)。