Input Number 数字输入框

通过鼠标或键盘,输入范围内的数值。

基础用法

<el-input-number> 元素上绑定一个 v-model 变量即可。

提示

当在输入框中输入无效的字符串时,由于错误的原因,输入值将向上传递 NaN

禁用状态

disabled 属性接受一个 boolean,如果这个值为 true,组件将被禁用。 如果你只需要控制数值在某一范围内,可以设置 min 属性来指定最小值和 max 属性来指定最大值。 默认情况下,最小值为 0

步数

允许您定义增量步骤。

设置 step 属性可以控制步长。

严格步数

step-strictly 属性接受一个 boolean。 如果这个属性被设置为 true,则输入的值只能是 step 的倍数。

精度

设置 precision 属性可以控制数值精度。

提示

precision 的值必须是一个非负整数,并且不能小于 step 的小数位数。

尺寸

使用 size 属性来设置附加尺寸,可选值为 largesmall

控制按钮位置

设置 controls-position 属性可以控制按钮位置。

自定义图标 2.6.3

使用 decrease-iconincrease-icon 设置自定义图标。

带前缀和后缀 2.8.4

使用 prefix 和 suffix 具名插槽。

人民币

API

属性

名称描述类型默认值
model-value / v-model绑定值number / null
min允许的最小值numberNumber.MIN_SAFE_INTEGER
max允许的最大值numberNumber.MAX_SAFE_INTEGER
步长步长number1
严格步长输入值是否只能为步长的倍数booleanfalse
精度输入值的精度number
size组件的尺寸枚举default
只读 2.2.16与原生输入框的 `readonly` 相同booleanfalse
disabled是否禁用booleanfalse
控制是否启用控制按钮booleantrue
控制按钮位置控制按钮的位置枚举
名称与原生输入框的 `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是否触发表单验证booleantrue
label a11y 已废弃与原生输入框的 `aria-label` 相同string
输入模式 2.10.3与原生输入框的 `inputmode` 相同string
对齐 2.10.5内部输入文本的对齐方式枚举'center'
禁用科学计数法 2.10.5禁止输入科学记数法(例如 'e')booleanfalse

插槽

名称描述
减少图标 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

来源

组件源码样式源码文档

贡献者