Input Number 数字输入框
在可自定义范围内输入数值。
基础用法
在 <u-input-number> 上使用 v-model 绑定变量即可。
TIP
当输入非法字符串时,组件会将 NaN 作为错误结果向上抛出。
禁用状态
disabled 为 true 时禁用。若仅需限制数值范围,可使用 min、max;默认最小值为 Number.MIN_SAFE_INTEGER。
步长
可定义递增步长。
使用 step 设置步长。
严格步长
step-strictly 为 true 时,输入值只能是步长的整数倍。
精度
使用 precision 设置数值精度。
TIP
precision 必须为非负整数,且不应小于 step 的小数位数。
尺寸
使用 size 可设为 large 或 small。
控制按钮位置
使用 controls-position 设置增减按钮位置。
自定义图标
使用 decrease-icon 与 increase-icon 自定义图标。
前缀与后缀
使用 prefix、suffix 具名插槽。
¥
RMB
TIP
为精度考虑,数值范围限制在 Number.MIN_SAFE_INTEGER 与 Number.MAX_SAFE_INTEGER 之间。
数字输入框 API
数字输入框 属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | number / null | — |
| min | 最小允许值 | number | Number.MIN_SAFE_INTEGER |
| max | 最大允许值 | number | Number.MAX_SAFE_INTEGER |
| step | 步长 | number | 1 |
| step-strictly | 是否严格按步长倍数取值 | boolean | false |
| precision | 数值精度 | number | — |
| size | 尺寸 | enum | default |
| readonly | 同原生 readonly | boolean | false |
| disabled | 是否禁用 | boolean | false |
| controls | 是否显示控制按钮 | boolean | true |
| controls-position | 控制按钮位置 | enum | — |
| name | 同原生 name | string | — |
| aria-label a11y | 同原生 aria-label | string | — |
| placeholder | 同原生 placeholder | string | — |
| id | 同原生 id | string | — |
| value-on-clear | 清空时的回填值 | number / null / enum | — |
| validate-event | 是否触发表单校验 | boolean | true |
| inputmode | 同原生 inputmode | string | — |
| align | 内部文本对齐 | enum | 'center' |
| disabled-scientific | 禁止输入科学计数法字符(如 e) | boolean | false |
数字输入框 插槽
| 名称 | 说明 |
|---|---|
| decrease-icon | 自定义减小按钮图标 |
| increase-icon | 自定义增大按钮图标 |
| prefix | 前缀内容 |
| suffix | 后缀内容 |
数字输入框 事件
| 名称 | 说明 | 类型 |
|---|---|---|
| change | 值变化时触发 | Function |
| blur | 失焦时触发 | Function |
| focus | 聚焦时触发 | Function |
数字输入框 暴露
| 名称 | 说明 | 类型 |
|---|---|---|
| focus | 聚焦输入框 | Function |
| blur | 使输入框失焦 | Function |