Skip to content

FormItem 表单项 ​

说明 ​

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

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

注意:

  • 未设置 span 时继承 y-form 的 span
  • 属性会分发给 el-col 或 el-form-item

用法示例 ​

见 Form 表单 · 用法示例

API ​

Attributes ​

支持 FormItem Attributes 及 Col 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