Input Number 数字输入框
仅允许输入标准的数值值,可自定义范围。
基础用法
只需要在 <el-input-number> 元素中绑定 v-model 变量即可。
提示
当输入框输入非法字符串时,输入值将向上层触发 NaN 作为错误结果。
禁用状态
disabled 属性接受一个 boolean,如果值为 true,则禁用该组件。 如果您只需要控制值在某个范围内,可以添加 min 属性来设置最小值,添加 max 属性来设置最大值。 默认情况下,最小值为 Number.MIN_SAFE_INTEGER。
步长
允许您定义递增步长。
添加 step 属性来设置步长。
严格步长
step-strictly 属性接受一个 boolean。 如果此属性为 true,则输入值只能是步长的倍数。
精度
添加 precision 属性来设置输入值的精度。
提示
precision 的值必须是非负整数,并且不应小于 step 的小数位数。
尺寸
使用 size 属性来设置 large 或 small 的额外尺寸。
按钮位置
设置 controls-position 来决定控制按钮的位置。
自定义图标 2.6.3
使用 decrease-icon 和 increase-icon 设置自定义图标。
前缀和后缀 2.8.4
使用名为 prefix 和 suffix 的插槽。
提示
出于精度考虑,输入数字限制在 Number.MIN_SAFE_INTEGER 到 Number.MAX_SAFE_INTEGER 之间。
格式化 2.14.0
使用 formatter 显示值,通常与 parser 一起使用。
当设置了 formatter 时,内部输入框的 type 会变为 text,这允许输入非数字字符。 在内部,组件使用 Number.parseFloat 处理输入:当解析成功时,解析出的数字写入 model-value;当解析返回 NaN 时,model-value 设置为 null。
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 | — |
| 占位符 | 原生 input 的 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 |
| tabindex 2.14.0 | 原生 input 的 tabindex | string / number | 0 |
| formatter 2.14.0 | 指定输入框中显示的值的格式 | Function | — |
| parser 2.14.0 | 指定从格式化输入中提取的值 | Function | — |
插槽
| 名称 | 描述 |
|---|---|
| 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 |