FormItem 表单项

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

基础用法

组件类型

表单校验

自定义插槽

属性

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

FormItemConfig

属性名	说明	类型	是否必须	默认值
prop	字段名	string	是	-
label	标签	string	否	-
type	组件类型	FormItemType | string	否	-
defaultValue	默认值	any	否	-
rules	验证规则	FormItemRule element-plus	否	-
required	是否必填	boolean	否	false
requiredMessage	必填提示信息	string	否	-
span	占用栅格列数	number	否	-
hidden	是否隐藏	boolean	否	false
disabled	是否禁用	boolean	否	false
placeholder	占位符（不填则按类型自动生成；范围类型请用 startPlaceholder / endPlaceholder）	string	否	-
startPlaceholder	范围类型起始占位符	string	否	-
endPlaceholder	范围类型结束占位符	string	否	-
options	选项配置	FormItemOption[] element-plus	否	-
attrs	组件属性（透传给具体组件）	Record	否	-
component	自定义组件	Component	否	-
itemAttrs	额外的 el-form-item 属性	Record	否	-
show	联动显示条件	Function (formData: Record) => boolean	否	-
disabledWhen	联动禁用条件	Function (formData: Record) => boolean	否	-
serialize	提交前字段序列化；返回含 value/fields/omit 键的对象即按转换输出处理，否则按业务值原样写回。可用于拆分日期范围、清洗值或派生附加字段	Function (value, formData, item) => T | FormTransformOutput<T> | void	否	-
deserialize	外部数据回填到表单时的反序列化	Function (value, formData, item) => T	否	-

TIP

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

插槽

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

事件

事件名	说明	类型
update:modelValue	表单数据变化时触发	Function (value: any) => void