Skip to content

FormItem 表单项

独立的表单项组件,用于构建自定义表单布局。这个组件是从 EzDynamicForm 中提取出来的基础表单项功能。

基础用法

组件类型

表单校验

自定义插槽

属性

属性名说明类型是否必须默认值
v-model表单数据any-
config表单项配置FormItemConfig-
formData整体表单数据Record<string, any>{}

FormItemConfig

属性名说明类型是否必须默认值
prop字段名string-
label标签string-
type组件类型FormItemType | string-
defaultValue默认值any-
rules验证规则FormItemRule-
required是否必填booleanfalse
requiredMessage必填提示信息string-
span占用栅格列数number-
hidden是否隐藏booleanfalse
disabled是否禁用booleanfalse
placeholder占位符string-
options选项配置FormItemOption[]-
attrs组件属性(透传给具体组件)Record-
slotName插槽名称(自定义渲染)string-
component自定义组件Component-
itemAttrs额外的 el-form-item 属性Record-
show联动显示条件Function-
disabledWhen联动禁用条件Function-

TIP

FormItemType 枚举定义请参考 DynamicForm 组件文档

插槽

插槽名说明参数
自定义表单项内容{ config: FormItemConfig, value: any, formData: Record }

事件

事件名说明类型
update:modelValue表单数据变化时触发Function

基于 MIT 许可发布