由输入框、选择器、单选框、多选框等控件组成,用以收集、校验、提交数据
包括各种表单项,比如输入框、选择器、开关、单选框、多选框等。
当垂直方向空间受限且表单较简单时,可以在一行内放置表单。
根据具体目标和制约因素,选择最佳的标签对齐方式。
在防止用户犯错的前提下,尽可能让用户更早地发现并纠正错误。
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
ref | 获得对表单元素的引用 | Element | - | null |
description | 辅助性文字 | string | - | '' |
inline | 行内表单模式 | boolean | true/false | false |
labelWidth | 表单域标签的宽度 | string | - | 80px |
model | 获得表单元素绑定的值 | any | - | null |
rules | 获得表单元素绑定的验证规则 | any | - | null |
labelPosition | 表单域标签的位置 | string | '' | 'top' | 'left' | 'right' | '' |
validateOnRuleChange | 规则改变时验证 | boolean | true/false | true |
hideRequiredAsterisk | 是否隐藏必填字段的标签旁边的红色星号 | boolean | true/false | false |
事件名称 | 说明 | 回调参数 |
---|---|---|
validate | 对整个表单进行校验的方法,参数为一个回调函数。该回调函数会在校验结束后被调用,并传入两个参数:是否校验成功和未通过校验的字段。若不传入回调函数,则会返回一个 promise | Function(callback: Function(boolean, object)) |
validateField | 对部分表单字段进行校验的方法 | Function(props: array | string, callback: Function(errorMessage: string)) |
resetFields | 对整个表单进行重置,将所有字段值重置为初始值并移除校验结果 | null |
clearValidate | 移除表单项的校验结果。传入待移除的表单项的 prop 属性或者 prop 组成的数组,如不传则移除整个表单的校验结果 | Function(props: array | string) |
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
prop | 表单域 model 字段,在使用 validate、resetFields 方法的情况下,该属性是必填的 | string | 传入 Form 组件的 model 中的字段 | - |
label | 标签文本 | string | - | - |
inline | 行内表单模式 | boolean | true/false | false |
labelWidth | 表单域标签的宽度 | string | - | 80px |
required | 是否必填,如不设置,则会根据校验规则自动生成 | boolean | true/false | false |
rules | 表单验证规则 | object | - | - |
trigger | 行内必填 触发事件 | string | click/hover | '' |
message | 行内必填 提示信息 | string | - | '' |
name | 说明 |
---|---|
icon | 标题前的icon |