---
category: Components
type: UI Views
component: Form
chinese: 表单子元素控件
english: FormItem
source: @alicd/next/form
---

`@alicd/next` 中 `Form.Item` 组件能力的扩展，增加了错误的提示方式 showValidateType，其他能力和 Form.Item 保持一致，要求必须放置在 Form 元素中，所有的 Field 类型的组件都是通过 FormItem 扩展出来的

## API

| 参数             | 说明                                                                                                                           | 类型        | 默认值     |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------- | ------- |
| prefix         | 样式前缀                                                                                                                         | String    | 'next-' |
| className      | 扩展class                                                                                                                      | String    | -       |
| style          | 自定义内联样式                                                                                                                      | Object    | -       |
| size           | 单个FormItem的size自定义，优先级高于Form的size, 并且当组件与 FormItem 一起使用时，组件自身设置 size 属性无效。**可选值**:'', 'large', 'small', 'medium' | Enum      | -       |
| label          | label 标签的文本                                                                                                                  | ReactNode | -       |
| labelCol       | label 标签布局，通 `<Col>` 组件，设置 span offset 值，如 {span: 8, offset: 16}，该项仅在垂直表单有效                                                  | Object    | -       |
| help           | 提示信息，如不设置，则会根据校验规则自动生成. 如果设置会受控（ps: 可以利用这点自定义错误位置,详细看demo自定义错误)                                                              | ReactNode | -       |
| validateStatus | 校验状态，如不设置，则会根据校验规则自动生成**可选值**:'''success'(成功)'error'(失败)'loading'(校验中)                               | Enum      | -       |
| hasFeedback    | 配合 validateStatus 属性使用，是否展示校验状态图标, 目前只有Input支持                                                                               | Boolean   | false   |
| wrapperCol     | 需要为输入控件设置布局样式时，使用该属性，用法同 labelCol                                                                                            | Object    | -       |
| extra          | 额外的提示信息，和 help 类似，当需要错误信息和提示文案同时出现时，可以使用这个。 位于错误信息后面                                                                         | ReactNode | -       |
| showValidateType | 应用于Field 类元素后，指定其展示错误的方式，可选值有 `help`、`tooltip` 两种| String | `help` |
| validateTooltipAlign | 当 `showValidateType` 为 `tooltip` 时，可选择 tooltip 弹出的位置 | `"tl"` 或 `"tr"` 或 `"bl"` 或 `"br"` | `"tl"` |