@alicd/crui-form-item
v0.0.5
Published
@alicd/next 中 Form.Item 组件能力的扩展,增加了错误的提示方式 showValidateType ,其他能力和 Form.Item 保持一致,必须放置在 Form 元素中
Downloads
72
Readme
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"
|