## 简介
数字选择器常用于数字信息输入的场景，用户可以通过鼠标或键盘精准、便捷地调整所需求输入的数字。
## 示例
```tsx
export * from '@alicloud/console-components/esm/rc/number-picker/demos/demo1';
export { default } from '@alicloud/console-components/esm/rc/number-picker/demos/demo1';
```
```tsx
export * from '@alicloud/console-components/esm/rc/number-picker/demos/demo2';
export { default } from '@alicloud/console-components/esm/rc/number-picker/demos/demo2';
```
## API
### NumberPicker
| 参数 | 说明 | 类型 | 默认值 | 是否必填 | 支持版本 |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | -------- |
| size | 大小 | 'large' | 'medium' | 'small' | 'medium' | | - |
| type | 设置类型(当 device 为 phone 时，NumberPicker 的类型强制为 normal，不可通过 type 修改) | 'normal' | 'inline' | 'normal' | | - |
| value | 当前值 | number | string | - | | - |
| defaultValue | 默认值 | number | string | - | | - |
| disabled | 是否禁用 | boolean | - | | - |
| step | 步长 | number | string | 1 | | - |
| precision | 保留小数点后位数 | number | 0 | | - |
| editable | 用户是否可以输入 | boolean | true | | - |
| autoFocus | 自动焦点 | boolean | - | | - |
| onChange | 数值被改变的事件
**签名**:
**参数**:
*value*: 新的数值。
*e*: DOM 事件对象。 | (
value: number | string | undefined,
e: (
| React.ChangeEvent\
| React.CompositionEvent\
| React.KeyboardEvent\
| React.FocusEvent\
| React.KeyboardEvent\
) & {
triggerType: 'up' | 'down' | undefined;
}
) => void | func.noop | | - |
| onKeyDown | 键盘按下
**签名**:
**参数**:
*e*: DOM 事件对象。 | InputProps\['onKeyDown'] | func.noop | | - |
| onFocus | 焦点获得
**签名**:
**参数**:
*e*: DOM 事件对象。 | InputProps\['onFocus'] | - | | - |
| onBlur | 焦点失去
**签名**:
**参数**:
*e*: DOM 事件对象。 | InputProps\['onBlur'] | func.noop | | - |
| onCorrect | 数值订正后的回调
**签名**:
**参数**:
*obj*: 包含 currentValue 和 oldValue 的对象。 | (obj: { currentValue: number | string; oldValue: number | string }) => void | func.noop | | - |
| max | 最大值 | number | string | - | | - |
| min | 最小值 | number | string | - | | - |
| format | 格式化当前值
**签名**:
**参数**:
*value*: 当前的数值。
**返回值**:
格式化后的值，可以是字符串或数字。 | (value: string | number) => string | number | - | | - |
| hasTrigger | 是否展示点击按钮 | boolean | true | | - |
| alwaysShowTrigger | 是否一直显示点击按钮(无须hover) | boolean | false | | - |
| label | 内联 左侧label | React.ReactNode | - | | - |
| innerAfter | 内联 右侧附加内容 | React.ReactNode | - | | - |
| upBtnProps | 增加按钮的props | ButtonProps | - | | - |
| downBtnProps | 减少按钮的props | ButtonProps | - | | - |
| isPreview | 是否为预览态 | boolean | - | | - |
| renderPreview | 预览态模式下渲染的内容
**签名**:
**参数**:
*value*: 当前值。
*props*: 传入的组件参数。
**返回值**:
Element 渲染内容。 | (value: number | string, props: NumberPickerProps) => React.ReactNode | - | | - |
| stringMode | 开启大数支持，输入输出均为string类型 | boolean | false | | 1.24 |
| state | 状态 | 'error' | 'success' | - | | - |
## 无障碍键盘操作指南
| 按键 | 说明 |
| :--------- | :------- |
| Up Arrow | 数字增加 |
| Down Arrow | 数字减小 |
## 更多示例
```tsx
```
```tsx
```
```tsx
```
```tsx
```
```tsx
```
```tsx
```
```tsx
```
```tsx
```
```tsx
```