数字输入框
使用可自定义范围的输入框来输入数值。
基础用法
提示
当向输入框输入无效字符串时，输入值将向上层发出 NaN 作为错误结果
禁用状态
步进
允许您定义增量步长。
严格步进
精度
提示
precision 的值必须是一个非负整数，并且不应小于 step 的小数位数。
尺寸
使用 size 属性来设置额外的尺寸，可选值为 large 或 small。
控制按钮位置
自定义图标 2.6.3
带前缀和后缀 2.8.4
提示
出于精度考虑，数字输入框的范围被限制在 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 |
| 步长 | 步长 | number | 1 |
| step-strictly | 输入值是否只能是步长的倍数 | boolean | false |
| precision | 输入值的精度 | number | — |
| size | 组件的尺寸 | 枚举 | default |
| readonly 2.2.16 | 与原生输入框的 `readonly` 相同 | boolean | false |
| disabled | 是否禁用 | boolean | false |
| controls | 是否启用控制按钮 | boolean | true |
| controls-position | 控制按钮的位置 | 枚举 | — |
| 名称 | 与原生输入框的 `name` 相同 | string | — |
| aria-label a11y 2.7.2 | 与原生输入框的 `aria-label` 相同 | string | — |
| 占位符 | 与原生输入框的 placeholder 相同 | string | — |
| id | 与原生 input 的 `id` 属性相同 | string | — |
| value-on-clear 2.2.0 | 当输入框被清空时应设置的值 | number / null / enum | — |
| validate-event | 是否触发表单验证 | boolean | true |
| label a11y 已废弃 | 与原生输入框的 `aria-label` 相同 | string | — |
| 输入模式 2.10.3 | 与原生输入框的 `inputmode` 相同 | string | — |
| align 2.10.5 | 内部输入文本的对齐方式 | 枚举 | 'center' |
| disabled-scientific 2.10.5 | 禁用科学记数法（例如'e'）的输入 | boolean | false |
插槽
| 名称 | 描述 |
|---|---|
| decrease-icon 2.6.3 | 自定义输入框按钮减少图标 |
| increase-icon 2.6.3 | 自定义输入框按钮增加图标 |
| prefix 2.8.4 | 作为输入框前缀的内容 |
| suffix 2.8.4 | 作为输入框后缀的内容 |
事件
| 名称 | 描述 | 类型 |
|---|---|---|
| change | 当值改变时触发 | Function |
| blur | 在 Input 失去焦点时触发 | Function |
| focus | 在 Input 获得焦点时触发 | Function |
暴露
| 名称 | 描述 | 类型 |
|---|---|---|
| focus | 使输入组件获得焦点 | Function |
| blur | 使输入组件失去焦点 | Function |
来源
贡献者
