Form 表单

由输入框、选择器、单选框、多选框等控件组成,用以收集、校验、提交数据

基本用法

包括各种表单项,比如输入框、选择器、开关、单选框、多选框等。

form: {"name":"","region":"","date1":"","date2":"","delivery":false,"type":[],"resource":"","desc":""}
活动名称
活动区域
  • 区域一
  • 区域二
活动时间
-
即时配送
活动性质
特殊资源
活动形式
显示代码

行内表单

当垂直方向空间受限且表单较简单时,可以在一行内放置表单。

formInline: {"user":"","region":""}
审批人
活动区域
  • 区域一
  • 区域二
显示代码

对齐方式

根据具体目标和制约因素,选择最佳的标签对齐方式。

formLabelAlign: {"name":"","region":"","type":""}

名称
活动区域
  • 区域一
  • 区域二
活动形式
显示代码

表单验证

在防止用户犯错的前提下,尽可能让用户更早地发现并纠正错误。

ruleForm: {"name":"","region":"","date1":"","date2":"","delivery":false,"type":[],"resource":"","desc":""}
活动名称
活动区域
  • 区域一
  • 区域二
活动时间
-
即时配送
活动性质
特殊资源
活动形式
显示代码

Attributes

Form-Item Attributes

参数 说明 类型 可选值 默认值
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

Methods

事件名称 说明 回调参数
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)

Form-Item Attributes

参数 说明 类型 可选值 默认值
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 - ''

Slot

name 说明
icon 标题前的icon