Input Number 数字输入框 ​

在可自定义范围内输入数值。

基础用法 ​

在 <u-input-number> 上使用 v-model 绑定变量即可。

TIP

当输入非法字符串时,组件会将 NaN 作为错误结果向上抛出。

禁用状态 ​

disabled 为 true 时禁用。若仅需限制数值范围,可使用 min、max;默认最小值为 Number.MIN_SAFE_INTEGER。

步长 ​

可定义递增步长。

使用 step 设置步长。

严格步长 ​

step-strictly 为 true 时,输入值只能是步长的整数倍。

精度 ​

使用 precision 设置数值精度。

TIP

precision 必须为非负整数,且不应小于 step 的小数位数。

尺寸 ​

使用 size 可设为 large 或 small。

控制按钮位置 ​

使用 controls-position 设置增减按钮位置。

自定义图标 ​

使用 decrease-icon 与 increase-icon 自定义图标。

前缀与后缀 ​

使用 prefix、suffix 具名插槽。

¥
RMB

TIP

为精度考虑,数值范围限制在 Number.MIN_SAFE_INTEGER 与 Number.MAX_SAFE_INTEGER 之间。

数字输入框 API ​

数字输入框 属性 ​

名称说明类型默认值
model-value / v-model绑定值number / null—
min最小允许值numberNumber.MIN_SAFE_INTEGER
max最大允许值numberNumber.MAX_SAFE_INTEGER
step步长number1
step-strictly是否严格按步长倍数取值booleanfalse
precision数值精度number—
size尺寸enumdefault
readonly同原生 readonlybooleanfalse
disabled是否禁用booleanfalse
controls是否显示控制按钮booleantrue
controls-position控制按钮位置enum—
name同原生 namestring—
aria-label a11y同原生 aria-labelstring—
placeholder同原生 placeholderstring—
id同原生 idstring—
value-on-clear清空时的回填值number / null / enum—
validate-event是否触发表单校验booleantrue
inputmode同原生 inputmodestring—
align内部文本对齐enum'center'
disabled-scientific禁止输入科学计数法字符(如 e)booleanfalse

数字输入框 插槽 ​

名称说明
decrease-icon自定义减小按钮图标
increase-icon自定义增大按钮图标
prefix前缀内容
suffix后缀内容

数字输入框 事件 ​

名称说明类型
change值变化时触发Function
blur失焦时触发Function
focus聚焦时触发Function

数字输入框 暴露 ​

名称说明类型
focus聚焦输入框Function
blur使输入框失焦Function