Input Number 数字输入框 ​

仅允许输入标准的数字值,可定义范围

基础用法 ​

要使用它,只需要在 <w-input-number> 元素中使用 v-model 绑定变量即可,变量的初始值即为默认值。disabled属性接受一个 Boolean,设置为true即可禁用整个组件。 ,如果你只需要控制数值在某一范围内,可以设置 min 属性和 max 属性, 默认最小值为 0。

TIP

当输入无效的字符串到输入框时,由于错误,输入值将把 NaN 导入到上层

步进 ​

允许定义递增递减的步进控制

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

严格步进 ​

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

精度 ​

设置 precision 属性可以控制数值精度,接收一个 Number。

TIP

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

末尾零 1.3.4 ​

设置 auto-pad-zero 属性可以控制设置 precision 后是否显示不必要的末尾零,接收一个 Boolean,默认为 true。设置为 false 时,1.4 不再显示为 1.40。

默认补零(precision=2)
去除末尾零(auto-pad-zero=false)

键盘交互 1.3.4 ​

设置 keyboard 属性可以控制是否开启键盘上下键增减,接收一个 Boolean,默认为 true。设置为 false 时,上下键(包括原生数字输入框的步进)不再改变数值。

键盘上下键可用(默认)
禁用键盘上下键(keyboard=false)

TIP

出于精度目的,输入数值的范围被限制在 Number.MIN_SAFE_INTEGER 到 Number.MAX_SAFE_INTEGER 之间。

格式化输入 1.3.4 ​

使用 formatter 显示值,通常同时使用 parser。

设置 formatter 后,内部输入框的 type 会变为 text,以允许输入非数字字符。组件内部使用 Number.parseFloat 处理输入:解析成功时,解析后的数字将写入 model-value;解析结果为 NaN 时,model-value 会被设置为 null。

四种状态 ​

使用 status 为输入框添加状态,使用 tips 为状态添加提示信息。

校验通过文本提示
校验存在严重问题文本提示
校验存在严重问题文本提示
校验不通过文本提示

按钮位置 ​

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

自定义图标 ​

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

带前缀和后缀 ​

使用前缀和标名后缀。

¥
RMB

API ​

Attributes ​

属性名说明类型默认值
model-value / v-model选中项绑定值number—
min设置计数器允许的最小值numberNumber.MIN_SAFE_INTEGER
max设置计数器允许的最大值numberNumber.MAX_SAFE_INTEGER
step计数器步长number1
step-strictly是否只能输入 step 的倍数booleanfalse
precision数值精度number—
auto-pad-zero 1.3.4设置 precision 后是否显示不必要的末尾零booleantrue
keyboard 1.3.4是否开启键盘上下键增减booleantrue
size计数器尺寸enumdefault
readonly原生 readonly 属性,是否只读booleanfalse
disabled是否禁用状态booleanfalse
controls是否使用控制按钮booleantrue
controls-position控制按钮位置enumright
name等价于原生 input name 属性string—
aria-label a11y等价于原生 input aria-label 属性string—
placeholder等价于原生 input placeholder 属性string—
id等价于原生 input id 属性string—
value-on-clear当输入框被清空时显示的值number / null / enumnull
validate-event是否触发表单验证booleantrue
label a11y deprecated等价于原生 input aria-label 属性string—
inputmode等价于原生 input inputmode 属性string—
align输入框内文本对齐方式enumcenter
disabled-scientific是否禁用科学计数法输入(如 'e')booleanfalse
tabindex等价于原生 input tabindex 属性string / number0
formatter 1.3.4指定输入值的展示格式Function—
parser 1.3.4指定从格式化输入中提取的值Function—
status输入框状态enum
tips输入框状态提示信息string—

Slots ​

事件名说明
decrease-icon自定义输入框按钮减少图标
increase-icon自定义输入框按钮增加图标
prefix输入框头部内容
suffix输入框尾部内容

Events ​

名称说明类型
change绑定值被改变时触发Function
blur在组件 Input 失去焦点时触发Function
focus在组件 Input 获得焦点时触发Function

Exposes ​

名称详情类型
focus使 input 组件获得焦点Function
blur使 input 组件失去焦点Function

Copyright 2025 Winning Health 版权所有