---
url: /components/input-number.md
---
# InputNumber 计数器

仅允许输入标准数字值的输入框：内置步进按钮与键盘上下键步进，min/max 自动钳制（到边界后对应按钮禁用），支持精度格式化与步长倍数约束。在 eb-form 中 change / blur 时机自动触发校验。

## 基础用法

v-model 绑定数值，min / max 约束有效范围：步进与手动输入超出范围时自动钳制到边界值；未绑定初始值时步进以 min（min 为负无穷时取 0）为基准。

## 步长与严格步长

step 定义每次步进的幅度（默认 1），支持小数；step-strictly 开启后绑定值只能是 step 的倍数，手动输入的值会在失焦时四舍五入到最近倍数，适合按固定档位取值的场景（如每 10 件一箱）。

## 范围与精度

min / max 是最常用的约束（如库存 0 - 100）；precision 固定小数位数，输入后按位格式化（如金额保留两位），建议与 step 的小数位对齐。

## 控制按钮

`controls-position="right"` 将步进按钮收拢到右侧上下排列（默认在输入框两侧）；`controls` 设为 false 时隐藏按钮，仅保留键盘步进。

## 尺寸

size 支持 large / small（缺省为默认高度），位于 eb-form 内时会继承表单尺寸。

## 禁用与只读

disabled 整体禁用（含步进按钮）；readonly 只读，输入与步进均被禁止，适合回显数值。

## 清空与替代值

手动清空输入框后，value-on-clear 不为 null 时以替代值写入绑定值（默认 null 表示清空后不更新），常与 min 配合保证业务上不允许空值。

## 格式化展示

`formatter` 控制展示格式（如千分位金额），`parser` 把输入文本解析回数值；只传 formatter 时聚焦显原始数值串、失焦回显格式化值，缺省 parser 会自动去千分位逗号解析。传入 formatter 或 parser 后输入框切换为文本输入（inputmode 为 decimal），以容纳格式字符。

## 前后缀块

`addon-before` / `addon-after` 在输入框外侧拼接前后缀块（货币符号、单位等），插槽 `addon-before` / `addon-after` 优先于同名 prop，可承载任意内容。

## API