Skip to content

FormItem 表单项

说明

y-form-item 整合 el-form-item + el-col,需与 Form 表单 配合使用。

用法示例(布局、联动、防抖等)见 Form 表单 · 用法示例

注意:

  • 未设置 span 时继承 y-formspan
  • 属性会分发给 el-colel-form-item

用法示例

Form 表单 · 用法示例

API

Attributes

支持 FormItem AttributesCol Attributes 的全部属性。下表列出常用项;未列出的 el-form-item 属性同样支持透传。

属性名说明类型默认值
span栅格占据列数,同 el-colnumber继承 y-form
offset栅格左侧间隔格数,同 el-colnumber0
push向右移动格数,同 el-colnumber0
pull向左移动格数,同 el-colnumber0
xs<768px 响应式栅格,同 el-colnumber / object
sm≥768px 响应式栅格,同 el-colnumber / object
md≥992px 响应式栅格,同 el-colnumber / object
lg≥1200px 响应式栅格,同 el-colnumber / object
xl≥1920px 响应式栅格,同 el-colnumber / object
tag自定义元素标签,同 el-colstring'div'
label标签文本,同 el-form-itemstring
prop模型字段名,同 el-form-itemstring / object
rules校验规则,同 el-form-itemobject
label-width标签宽度,同 el-form-itemstring / number
required是否必填,同 el-form-itemboolean
inline-message是否行内展示校验信息,同 el-form-itemboolean

Slots

名称说明参数
default表单控件内容
label自定义标签内容object
error自定义校验错误内容object

Exposes

名称说明类型
size表单项尺寸,同 el-form-itemobject
validateMessage校验提示信息,同 el-form-itemobject
validateState校验状态,同 el-form-itemobject
validate校验表单项,同 el-form-itemfunction
clearValidate移除该表单项的校验结果,同 el-form-itemfunction
resetField重置该表单项为初始值并移除校验结果,同 el-form-itemfunction
setInitialValue设置该字段初始值,resetField 时将重置到此值,同 el-form-itemfunction