Skip to content

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步长string1
value当前值(受控)string

事件

事件说明
oas-change步进或失焦变化,detail: { value }(数字)