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 属性来设置 largesmall 的额外尺寸。

按钮位置

设置 controls-position 来决定控制按钮的位置。

自定义图标 2.6.3

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

前缀和后缀 2.8.4

使用名为 prefix 和 suffix 的插槽。

RMB

提示

出于精度考虑,输入数字限制在 Number.MIN_SAFE_INTEGERNumber.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最小允许值numberNumber.MIN_SAFE_INTEGER
max最大允许值numberNumber.MAX_SAFE_INTEGER
步长步长number1
step-strictly输入值是否只能是步长的倍数booleanfalse
precision输入值的精度number
size组件尺寸枚举default
readonly 只读 2.2.16与原生输入框的 `readonly` 相同booleanfalse
disabled是否禁用booleanfalse
controls是否启用控制按钮booleantrue
controls-position控制按钮的位置枚举
名称与原生输入框的 `name` 相同string
aria-label a11y 2.7.2与原生输入框的 `aria-label` 相同string
占位符原生 input 的 placeholderstring
id与原生 input 的 `id` 属性相同string
value-on-clear 2.2.0输入框清空时应设置的值number / null / enum
validate-event是否触发表单验证booleantrue
label a11y 已废弃与原生输入框的 `aria-label` 相同string
输入模式 2.10.3与原生输入框的 `inputmode` 相同string
align 对齐方式 2.10.5内部输入文本的对齐方式枚举'center'
disabled-scientific 2.10.5禁用科学计数法(例如 'e')的输入booleanfalse
tabindex 2.14.0原生 input 的 tabindexstring / number0
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

来源

组件样式文档

贡献者