FormItem 表单项
独立的表单项组件,用于构建自定义表单布局。这个组件是从 EzDynamicForm 中提取出来的基础表单项功能。
基础用法
组件类型
表单校验
自定义插槽
属性
| 属性名 | 说明 | 类型 | 是否必须 | 默认值 |
|---|---|---|---|---|
| v-model | 表单数据 | any | 否 | - |
| config | 表单项配置 | FormItemConfig | 是 | - |
| formData | 整体表单数据 | Record<string, any> | 否 | {} |
FormItemConfig
| 属性名 | 说明 | 类型 | 是否必须 | 默认值 |
|---|---|---|---|---|
| prop | 字段名 | string | 是 | - |
| label | 标签 | string | 否 | - |
| type | 组件类型 | FormItemType | string | 否 | - |
| defaultValue | 默认值 | any | 否 | - |
| rules | 验证规则 | FormItemRule | 否 | - |
| required | 是否必填 | boolean | 否 | false |
| requiredMessage | 必填提示信息 | string | 否 | - |
| span | 占用栅格列数 | number | 否 | - |
| hidden | 是否隐藏 | boolean | 否 | false |
| disabled | 是否禁用 | boolean | 否 | false |
| 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 |