Input Number 数字输入框
仅允许输入标准的数字值,可定义范围
基础用法
TIP
当输入无效的字符串到输入框时,由于错误,输入值将把 NaN 导入到上层
禁用状态
步进
允许定义递增递减的步进控制
严格步进
精度
TIP
precision 的值必须是一个非负整数,并且不能小于 step 的小数位数。
不同的输入框尺寸
使用 size 属性额外配置尺寸,可选的尺寸大小为:large 或 small
按钮位置
自定义图标 2.6.3
带前缀和后缀2.8.4
TIP
为了确保精度,输入的数值被限制在 Number.MIN_SAFE_INTEGER 到 Number.MAX_SAFE_INTEGER 之间。
API
Attributes
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 选中项绑定值 | number / null | — |
| min | 设置计数器允许的最小值 | number | Number.MIN_SAFE_INTEGER |
| max | 设置计数器允许的最大值 | number | Number.MAX_SAFE_INTEGER |
| step | 计数器步长 | number | 1 |
| step-strictly | 是否只能输入 step 的倍数 | boolean | false |
| precision | 数值精度 | number | — |
| size | 计数器尺寸 | enum | default |
| readonly 2.2.16 | 原生 readonly 属性,是否只读 | boolean | false |
| disabled | 是否禁用状态 | boolean | false |
| controls | 是否使用控制按钮 | boolean | true |
| controls-position | 控制按钮位置 | enum | — |
| name | 等价于原生 input name 属性 | string | — |
| aria-label a11y 2.7.2 | 等价于原生 input aria-label 属性 | string | — |
| placeholder | 等价于原生 input placeholder 属性 | string | — |
| id | 等价于原生 input id 属性 | string | — |
| value-on-clear 2.2.0 | 当输入框被清空时显示的值 | number / null / enum | — |
| validate-event | 是否触发表单验证 | boolean | true |
| label a11y deprecated | 等价于原生 input aria-label 属性 | string | — |
| inputmode 2.10.3 | 等价于原生 input inputmode 属性 | string | — |
| align 2.10.5 | 内部输入文本对齐 | enum | 'center' |
| disabled-scientific 2.10.5 | 禁用科学计数法的输入(例如输入 'e') | boolean | false |
Slots
| 插槽名 | 说明 |
|---|---|
| decrease-icon 2.6.3 | 自定义输入框按钮减少图标 |
| increase-icon 2.6.3 | 自定义输入框按钮增加图标 |
| prefix 2.8.4 | 输入框头部内容 |
| suffix 2.8.4 | 输入框尾部内容 |
Events
| 名称 | 说明 | 类型 |
|---|---|---|
| change | 绑定值被改变时触发 | Function |
| blur | 在组件 Input 失去焦点时触发 | Function |
| focus | 在组件 Input 获得焦点时触发 | Function |
Exposes
| 名称 | 详情 | 类型 |
|---|---|---|
| focus | 使 input 组件获得焦点 | Function |
| blur | 使 input 组件失去焦点 | Function |