Input Number 数字输入框

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

基础用法

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

TIP

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

禁用状态

disabledtrue 时禁用。若仅需限制数值范围,可使用 minmax;默认最小值为 Number.MIN_SAFE_INTEGER

步长

可定义递增步长。

使用 step 设置步长。

严格步长

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

精度

使用 precision 设置数值精度。

TIP

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

尺寸

使用 size 可设为 largesmall

控制按钮位置

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

自定义图标

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

前缀与后缀

使用 prefixsuffix 具名插槽。

RMB

TIP

为精度考虑,数值范围限制在 Number.MIN_SAFE_INTEGERNumber.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禁止输入科学计数法字符(如 ebooleanfalse

数字输入框 插槽

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

数字输入框 事件

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

数字输入框 暴露

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