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

参数类型默认值说明
modelValuenumber0当前值(v-model)
minnumber-Infinity最小值
maxnumberInfinity最大值
stepnumber1步长
precisionnumber数值精度(小数位数)
size'sm' | 'md' | 'lg''md'尺寸
disabledbooleanfalse是否禁用
readonlybooleanfalse是否只读
placeholderstring''占位文本
controlsbooleantrue是否显示增减按钮
controlsPosition'side' | 'right''side'按钮位置:side 左右排列,right 右侧纵向排列
prefixTextstring''前缀文本
suffixTextstring''后缀文本
errorstring''错误状态
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使输入框失去焦点