InputNumber 数字输入框
原生 <input type="number"> 增强,带步进按钮并支持范围约束。
基础用法
基础用法
范围与步长
min / max / step
超出 min / max 会被钳制;到达边界时对应步进按钮自动禁用。
精度
precision
precision 控制步进与钳制时的小数位数。
禁用
禁用
无障碍名称(label)
label(可访问名称)
label 作为输入框的可访问名称(aria-label):设置后读屏朗读该名称;未设置时回退内置文案「数字输入框」(数字输入框没有 placeholder 回退链)。步进按钮「增加 / 减少」的可访问名称同样走内置文案。
事件
变化事件
监听 oas-change(步进或失焦时触发,detail: { value }):
API
属性
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
disabled | 禁用 | boolean | — |
label | 可访问名称(aria-label 来源,未设时回退内置文案「数字输入框」) | — | — |
max | 范围,越界自动钳制 | string | — |
min | 范围,越界自动钳制 | string | — |
precision | 小数位数 | string | — |
step | 步长 | string | 1 |
value | 当前值(受控) | string | — |
事件
| 事件 | 说明 |
|---|---|
oas-change | 步进或失焦变化,detail: { value }(数字) |