InputNumber 数字输入框
用于输入数字,支持步进、精度、范围限制、按钮位置等。
基础用法
通过 v-model 双向绑定数值:
当前值:0
步长与范围
设置 min、max、step 控制数值范围与步长:
0-100,步长 5,当前值:50
精度
设置 precision 控制小数位数:
精度 0
精度 2
不同尺寸
设置 size 属性使用三种预设尺寸:
按钮位置
设置 controlsPosition 为 right 将按钮放在右侧纵向排列:
side(默认)
right
前后缀
使用 prefixText / suffixText 或对应插槽添加前后缀:
¥
%
🌡
禁用与只读
设置 disabled 禁用或 readonly 只读:
格式化
使用 formatter 和 parser 自定义显示格式:
实际值:1000
无按钮
设置 controls 为 false 隐藏增减按钮:
Props
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | number | 0 | 当前值(v-model) |
min | number | -Infinity | 最小值 |
max | number | Infinity | 最大值 |
step | number | 1 | 步长 |
precision | number | — | 数值精度(小数位数) |
size | 'sm' | 'md' | 'lg' | 'md' | 尺寸 |
disabled | boolean | false | 是否禁用 |
readonly | boolean | false | 是否只读 |
placeholder | string | '' | 占位文本 |
controls | boolean | true | 是否显示增减按钮 |
controlsPosition | 'side' | 'right' | 'side' | 按钮位置:side 左右排列,right 右侧纵向排列 |
prefixText | string | '' | 前缀文本 |
suffixText | string | '' | 后缀文本 |
error | string | '' | 错误状态 |
formatter | (value: number) => string | — | 格式化显示值 |
parser | (value: string) => number | — | 反向解析显示值为数字 |
Events
| 事件名 | 类型 | 说明 |
|---|---|---|
update:modelValue | (value: number) => void | 值变化时触发 |
change | (value: number) => void | 值变化时触发 |
focus | (event: FocusEvent) => void | 获得焦点时触发 |
blur | (event: FocusEvent) => void | 失去焦点时触发 |
Slots
| 插槽名 | 说明 |
|---|---|
prefix | 前缀内容(优先于 prefixText) |
suffix | 后缀内容(优先于 suffixText) |
Methods
| 方法名 | 类型 | 说明 |
|---|---|---|
focus | () => void | 使输入框获得焦点 |
blur | () => void | 使输入框失去焦点 |