Input Number 数字输入框
通过鼠标或键盘,输入范围内的数值。
基础用法
在 <el-input-number>
元素上绑定一个 v-model
变量即可。
提示
当在输入框中输入无效的字符串时,由于错误的原因,输入值将向上传递 NaN
禁用状态
disabled
属性接受一个 boolean
,如果这个值为 true
,组件将被禁用。 如果你只需要控制数值在某一范围内,可以设置 min
属性来指定最小值和 max
属性来指定最大值。 默认情况下,最小值为 0
。
步数
允许您定义增量步骤。
设置 step
属性可以控制步长。
严格步数
step-strictly
属性接受一个 boolean
。 如果这个属性被设置为 true
,则输入的值只能是 step
的倍数。
精度
设置 precision
属性可以控制数值精度。
提示
precision
的值必须是一个非负整数,并且不能小于 step
的小数位数。
尺寸
使用 size
属性来设置附加尺寸,可选值为 large
或 small
。
控制按钮位置
设置 controls-position
属性可以控制按钮位置。
自定义图标 2.6.3
使用 decrease-icon
和 increase-icon
设置自定义图标。
带前缀和后缀 2.8.4
使用 prefix 和 suffix 具名插槽。
API
属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
model-value / v-model | 绑定值 | number / null | — |
min | 允许的最小值 | number | Number.MIN_SAFE_INTEGER |
max | 允许的最大值 | number | Number.MAX_SAFE_INTEGER |
步长 | 步长 | number | 1 |
严格步长 | 输入值是否只能为步长的倍数 | boolean | false |
精度 | 输入值的精度 | number | — |
size | 组件的尺寸 | 枚举 | default |
只读 2.2.16 | 与原生输入框的 `readonly` 相同 | boolean | false |
disabled | 是否禁用 | boolean | false |
控制 | 是否启用控制按钮 | boolean | true |
控制按钮位置 | 控制按钮的位置 | 枚举 | — |
名称 | 与原生输入框的 `name` 相同 | string | — |
aria-label a11y 2.7.2 | 与原生输入框的 `aria-label` 相同 | string | — |
占位符 | 与原生 input 中的 placeholder 相同 | string | — |
id | 与原生 input 的 `id` 属性相同 | string | — |
清除时的值 2.2.0 | 当输入框被清空时,应该设置的值 | number / null / enum | — |
validate-event | 是否触发表单验证 | boolean | true |
label a11y 已废弃 | 与原生输入框的 `aria-label` 相同 | string | — |
输入模式 2.10.3 | 与原生输入框的 `inputmode` 相同 | string | — |
对齐 2.10.5 | 内部输入文本的对齐方式 | 枚举 | 'center' |
禁用科学计数法 2.10.5 | 禁止输入科学记数法(例如 'e') | boolean | false |
插槽
名称 | 描述 |
---|---|
减少图标 2.6.3 | 自定义输入框按钮减少图标 |
增加图标 2.6.3 | 自定义输入框按钮增加图标 |
前缀 2.8.4 | 作为输入框前缀的内容 |
后缀 2.8.4 | 作为 Input 后缀的内容 |
事件
名称 | 描述 | 类型 |
---|---|---|
change | 值改变时触发 | Function |
blur | 在 Input 失去焦点时触发 | Function |
focus | 在 Input 获得焦点时触发 | Function |
暴露
名称 | 描述 | 类型 |
---|---|---|
focus | 使输入组件获得焦点 | Function |
blur | 使输入组件失去焦点 | Function |