> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# NumberField 数字输入框

> NumberField 数字输入框组件参考，介绍精度、步长、上下限等属性配置，自动校验并订正输入的数值。

## 何时使用

* 数字选择器，并对输入的数据做正确性检查、自动订正；

## 组件示例

<iframe src="https://www.aliwork.com/developer/number-field-v2?isRenderNav=false" width="100%" height="480" frameBorder="0" />

## 组件属性

| 属性                    | 说明                                                              | 类型                                                                  | 默认值        |
| --------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------- | ---------- |
| `behavior`            | 表单组件显示状态                                                        | [Behavior](/zh/open/yida/components/interface#behavior)             | `'NORMAL'` |
| `innerAfter`          | 数字输入框单位文案                                                       | `string`                                                            | -          |
| `innerBefore`         | 表单组件前缀文案                                                        | `string`                                                            | -          |
| `label`               | 表单组件标题                                                          | `string`                                                            | -          |
| `labelAlign`          | 表单组件标题的位置                                                       | `'left' \| 'top'`                                                   | `'top'`    |
| `labelColOffset`      | 设置标题的偏移位置，配置值为栅格值，1代表1/24                                       | `number`                                                            | `0`        |
| `labelColSpan`        | 设置标题的占位宽度，配置值为栅格值，1代表1/24                                       | `number`                                                            | `4`        |
| `labelTextAlign`      | 表单组件的标题对齐方式                                                     | `'left' \| 'right'`                                                 | `'right'`  |
| `labelTipsIcon`       | 表单组件标题提示信息入口图标，当labelTipsTypes取值为 **text** 或 **render** 时生效     | `string`                                                            | -          |
| `labelTipsRender`     | 表单组件标题提示信息自定义渲染方法，当labelTipsTypes取值为 **render** 时生效             | `(props: IComponentProps) => ReactNode`                             | -          |
| `labelTipsText`       | 表单组件标题提示文本信息，当labelTipsTypes取值为 **text** 时生效                    | `string`                                                            | -          |
| `labelTipsTypes`      | 表单组件标题提示信息类型设置                                                  | [LabelTipsTypes](/zh/open/yida/components/interface#labelTipsTypes) | `'none'`   |
| `onChange`            | 表单组件值发生改变事件                                                     | `({value: number}) => void`                                         | -          |
| `placeholder`         | 表单组件占位提示信息                                                      | `string`                                                            | `'请输入数字'`  |
| `precision`           | 小数点位数，取值范围在0 - 20                                               | `number`                                                            | `0`        |
| `size`                | 表单组件尺寸                                                          | [Size](/zh/open/yida/components/interface#size)                     | `'medium'` |
| `thousandsSeparators` | 是否进行千分位分隔                                                       | `boolean`                                                           | `false`    |
| `tips`                | 表单组件描述信息，展示在控件下方                                                | `string`                                                            | -          |
| `validation`          | 表单组件校验设置，具体使用详见[表单校验文档](/zh/open/yida/guide/concept/validation) | [Validation\[\]](/zh/open/yida/components/interface#validation)     | `[]`       |
| `value`               | 表单组件的默认值                                                        | `number`                                                            | -          |
| `wrapperColOffset`    | 设置表单组件的偏移位置，设置值为栅格值，1代表1/24                                     | `number`                                                            | `0`        |
| `wrapperColSpan`      | 设置表单组件的占位宽度，设置值为栅格值，1代表1/24                                     | `number`                                                            | `0`        |