数字输入框 InputNumber
通过鼠标或者键盘输入范围内的标准数值。
格式化展示值
Section titled “格式化展示值”通过 formatter 和 parser 配合使用可以定义输入框展示值。
指定 mode 为 button 来使用带按钮的数字输入框。
v-model 的触发事件
Section titled “v-model 的触发事件”数字输入框默认在 blur 或者按下 Enter 时会修改绑定的值，通过设置属性 model-event=“input” 让组件在输入时修改绑定的值。注意：在此模式下，输入时的值会超出设置的 min/max，组件会在失焦时修正值的大小。
字符串值兼容
Section titled “字符串值兼容”当外层表单把数字字段保存为字符串时，组件会保留字符串类型，在步进、输入和清空后仍然按字符串回写。
通过 precision 来设置数字精度。当 precision 小于 step 的小数位时，精度取 step 的小数个数。
通过指定 prefix 和 suffix 插槽来在输入框内添加前缀和后缀。
设置 size 可以使用四种尺寸（mini, small, medium, large）的数字输入框。高度分别对应24px、28px、32px、36px。
通过指定 plus 和 minus 插槽来修改数值增减操作的图标。
<input-number> Props
Section titled “<input-number> Props”| 参数名 | 描述 | 类型 | 默认值 | 版本 |
| — | — | — | :-: | :– | — |
| model-value (v-model) | 绑定值，支持数字或数字字符串 | string \| number \| null | - | |
| default-value | 默认值（非受控模式），支持数字或数字字符串 | string \| number \| null | - | |
| mode | 模式（embed：按钮内嵌模式，button：左右按钮模式） | 'embed' \| 'button' | 'embed' | |
| precision | 数字精度 | number | - | |
| step | 数字变化步长 | number | 1 | |
| disabled | 是否禁用 | boolean | false | |
| error | 是否为错误状态 | boolean | false | |
| max | 最大值 | number | Infinity | |
| min | 最小值 | number | -Infinity | |
| formatter | 定义输入框展示值 | func | - | |
| parser | 从 formatter 转换为数字，和 formatter 搭配使用 | func | - | |
| placeholder | 输入框提示文字 | string | - | |
| fit-width | 宽度是否适应文字内容 | boolean | false | |
| max-w-full | 最大宽度是否限制为父容器宽度 | boolean | true | |
| hide-button | 是否隐藏按钮 | boolean | false | |
| size | 输入框大小 | 'mini' \| 'small' \| 'medium' \| 'large' | 'medium' | |
| allow-clear | 是否允许清空输入框 | boolean | false | |
| model-event | 触发 v-model 的事件 | 'change' \| 'input' | 'change' | |
| readonly | 只读 | boolean | string | false | 2.33.1 |
| input-attrs | 内部 input 元素的属性 | object | - | 2.52.0 |
<input-number> Events
Section titled “<input-number> Events”| 事件名 | 描述 | 参数 | 版本 |
|---|---|---|---|
| change | 值发生改变时触发；当 v-model 为字符串时保留字符串类型 |
value: string | number | undefinedev: Event |
|
| focus | 输入框获取焦点时触发 | ev: FocusEvent |
|
| blur | 输入框失去焦点时触发 | ev: FocusEvent |
|
| clear | 用户点击清除按钮时触发 | ev: Event |
2.23.0 |
| input | 输入时触发；当 v-model 为字符串时保留字符串类型 |
value: string | number | undefinedinputValue: stringev: Event |
2.27.0 |
| keydown | 按下键盘时触发 | ev: MouseEvent |
2.56.0 |
<input-number> Methods
Section titled “<input-number> Methods”| 方法名 | 描述 | 参数 | 返回值 |
|---|---|---|---|
| focus | 使输入框获取焦点 | - | - |
| blur | 使输入框失去焦点 | - | - |
<input-number> Slots
Section titled “<input-number> Slots”| 插槽名 | 描述 | 参数 |
|---|---|---|
| minus | 数值减少图标 | - |
| plus | 数值增加图标 | - |
| append | 后置标签 | - |
| prepend | 前置标签 | - |
| suffix | 后缀 | - |
| prefix | 前缀 | - |