InputNumber 数字输入框
输入数量、金额等数字内容。
基础用法
通过 min、max 限制范围。onChange 返回数值,清空时返回 null。输入中的负号或小数点会暂时保留,失焦或按 Enter 时校正范围与精度。
basic.tsx
示例
单位与小数
使用 prefix、suffix 展示单位,通过 step 和 precision 设置步长与小数位数。controls={false} 隐藏增减按钮。
units.tsx
只读与禁用
只读状态保留数值但禁止编辑;禁用状态不可交互。
states.tsx
格式化显示
使用 grouping 显示本地化数字分组。自定义格式时,formatter 负责显示,parser 将输入文字还原为数值;格式化不改变原生表单提交的原始值。
formatting.tsx
高精度数值
超出 JavaScript Number 安全精度时,使用 stringMode。该模式下 value、defaultValue、step、min 和 max 使用字符串,onChange 返回字符串或 null;不要先转成 Number。
exact.tsx
API
InputNumber API
表单接入
设置 name 可通过 FormData 提交原始数值。非受控字段支持表单重置,受控字段需同步重置应用状态。required、form 等原生属性传给输入元素;表单接入见 Form。
NumericInputNumber API
这里只列出该模式的类型差异;通用参数见本页主 API 表。
StringInputNumber API
这里只列出该模式的类型差异;通用参数见本页主 API 表。