# input-number (w-input-number)

- **Import**: `WInputNumber` from `win-design-next`
- **Tag**: `<w-input-number>`
- **说明**: Input Number 数字输入框
- **分类**: data-entry
- **Skill 版本**: V1.1.0
- **适配组件库**: win-design-next 1.2.2
- **API 来源**: `docs/zh-CN/component/input-number.md`

## API

## API

### Attributes

| 属性名                      | 说明                                | 类型                                                                | 默认值    |
| --------------------------- | ----------------------------------- | ------------------------------------------------------------------- | --------- |
| model-value / v-model       | 选中项绑定值                        | ^[number]                                                           | —         |
| min                         | 设置计数器允许的最小值              | ^[number]                                                           | -Infinity |
| max                         | 设置计数器允许的最大值              | ^[number]                                                           | Infinity  |
| step                        | 计数器步长                          | ^[number]                                                           | 1         |
| step-strictly               | 是否只能输入 step 的倍数            | ^[boolean]                                                          | false     |
| precision                   | 数值精度                            | ^[number]                                                           | —         |
| size                        | 计数器尺寸                          | ^[enum]`'large' \| 'default' \| 'mini' \| 'small'`                  | 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]`'min' \| 'max'`                       | —         |
| validate-event              | 是否触发表单验证                    | ^[boolean]                                                          | true      |
| label ^(a11y) ^(deprecated) | 等价于原生 input `aria-label` 属性  | ^[string]                                                           | —         |
| status                      | 输入框状态                          | ^[enum]`'success' \| 'warning' \| 'error' \| 'danger' \| 'default'` |           |
| tips                        | 输入框状态提示信息                  | ^[string]                                                           | —         |

### Slots

| 事件名        | 说明                     |
| ------------- | ------------------------ |
| decrease-icon | 自定义输入框按钮减少图标 |
| increase-icon | 自定义输入框按钮增加图标 |
| prefix        | 输入框头部内容           |
| suffix        | 输入框尾部内容           |

### Events

| 名称   | 说明                        | 类型                                                                                    |
| ------ | --------------------------- | --------------------------------------------------------------------------------------- |
| change | 绑定值被改变时触发          | ^[Function]`(currentValue: number \| undefined, oldValue: number \| undefined) => void` |
| blur   | 在组件 Input 失去焦点时触发 | ^[Function]`(event: FocusEvent) => void`                                                |
| focus  | 在组件 Input 获得焦点时触发 | ^[Function]`(event: FocusEvent) => void`                                                |

### Exposes

| 名称  | 详情                  | 类型                    |
| ----- | --------------------- | ----------------------- |
| focus | 使 input 组件获得焦点 | ^[Function]`() => void` |
| blur  | 使 input 组件失去焦点 | ^[Function]`() => void` |
