数据录入与表单

NnInputNumber 数字输入框

带范围、精度和附加内容的数字输入。

示例

API

Props

名称	类型	默认值	说明
value	number | string | null	null	当前值。有效输入会通过事件输出 number，清空输出 null。
min	number | string	—	原生最小值，并在失焦或 Enter 提交草稿时执行下限裁剪。
max	number | string	—	原生最大值，并在失焦或 Enter 提交草稿时执行上限裁剪。
step	number | string	1	原生步长。
precision	number | string	—	0..100 的整数会用 toFixed 舍入并转回数字。源码只检查非负整数，超过 JavaScript 支持上限 100 会抛出 RangeError，调用方应先限制范围。
status	string	''	error 使用错误样式；其他值没有专用样式。
disabled	boolean	false	禁用输入。
placeholder	string	''	占位文字。
addonAfter	string | number	''	数字输入后的静态附加内容；数字 0 会被当作空值而不渲染。

Events

事件	参数	说明
update:value	(value: number | null)	有效数字输入、清空或提交裁剪值时触发。
change	(value: number | null)	与数值更新同时触发。
pressEnter	(event: KeyboardEvent)	先提交并裁剪当前草稿，再触发。

输入过程中的有效数字会立即触发更新，但 min/max 裁剪只在失焦或 Enter 时执行。无法解析的非空草稿不触发事件；提交时会恢复到 Prop 值。