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。
键盘交互 1.3.4
设置 keyboard 属性可以控制是否开启键盘上下键增减,接收一个 Boolean,默认为 true。设置为 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 设置自定义图标。
带前缀和后缀
使用前缀和标名后缀。
API
Attributes
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 选中项绑定值 | number | — |
| min | 设置计数器允许的最小值 | number | Number.MIN_SAFE_INTEGER |
| max | 设置计数器允许的最大值 | number | Number.MAX_SAFE_INTEGER |
| step | 计数器步长 | number | 1 |
| step-strictly | 是否只能输入 step 的倍数 | boolean | false |
| precision | 数值精度 | number | — |
| auto-pad-zero 1.3.4 | 设置 precision 后是否显示不必要的末尾零 | boolean | true |
| keyboard 1.3.4 | 是否开启键盘上下键增减 | boolean | true |
| size | 计数器尺寸 | enum | default |
| readonly | 原生 readonly 属性,是否只读 | boolean | false |
| disabled | 是否禁用状态 | boolean | false |
| controls | 是否使用控制按钮 | boolean | true |
| controls-position | 控制按钮位置 | enum | right |
| name | 等价于原生 input name 属性 | string | — |
| aria-label a11y | 等价于原生 input aria-label 属性 | string | — |
| placeholder | 等价于原生 input placeholder 属性 | string | — |
| id | 等价于原生 input id 属性 | string | — |
| value-on-clear | 当输入框被清空时显示的值 | number / null / enum | null |
| validate-event | 是否触发表单验证 | boolean | true |
| label a11y deprecated | 等价于原生 input aria-label 属性 | string | — |
| inputmode | 等价于原生 input inputmode 属性 | string | — |
| align | 输入框内文本对齐方式 | enum | center |
| disabled-scientific | 是否禁用科学计数法输入(如 'e') | boolean | false |
| tabindex | 等价于原生 input tabindex 属性 | string / number | 0 |
| 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 版权所有

