核心是用结构化配置驱动表单渲染,通过 type、key、label、rules 等字段定义表单项,结合 v-for + :is 动态渲染组件并绑定数据,支持条件显隐、联动、异步校验及自动提交逻辑。

核心是用一份结构化配置(比如 JSON)驱动组件渲染,而不是在模板里硬写每个 el-form-item。配置描述“要什么字段、怎么显示、何时出现、如何校验”,Vue 组件读取后自动组装界面和逻辑。
配置结构要清晰定义字段元信息
每个表单项至少包含类型(type)、绑定键名(key 或 formDataKey)、标签(label)和校验规则(rules)。可选扩展如占位符、是否禁用、栅格宽度、显示条件等。
-
type 对应 UI 组件,如
"input"、"select"、"date-picker",也可直接写组件引用(如ElInput) - key 是数据模型中的字段名,用于双向绑定和提交收集
- rules 可复用 Element Plus 的校验规则数组,或自定义函数
- isShow 或 visibleIf 字段支持传入函数,接收当前整个表单数据,返回布尔值控制显隐
用渲染函数或 v-for + component 动态挂载
不推荐在 template 里写一堆 v-if 判断类型。更干净的做法是:遍历配置数组,用 <component :is="item.type"></component> 渲染控件,并通过 v-model 绑定到响应式数据对象的对应 key 上。
- 借助
h()函数可在 setup 中精细控制 vnode,适合复杂嵌套或插槽注入 - 简单场景下,
v-for配合:is已足够,再包一层<el-form-item></el-form-item>并传入label和prop - 注意:动态组件需确保 type 值合法,
"input"这类原生标签要加引号,组件引用要先导入并注册(或全局注册)
联动与条件渲染靠数据驱动,不是 DOM 操作
字段是否显示、选项是否禁用、默认值如何设置,全部基于当前表单数据状态计算,而不是手动 $nextTick 或 ref 操作 DOM。
- 例如“选择组织为公司时显示入职日期”:配置中给日期字段加
isShow: (data) => data.organization === 'company' - 下拉选项可配置
options数组,也可配api字段让组件自动请求远程数据 - 所有依赖关系都在配置里声明,渲染器统一响应式监听,无需额外 watch
校验和提交逻辑由配置自动组装
不用手写 rules 对象。把配置里的 rules 映射成 Element Plus 接受的格式,再传给 el-form 的 :model 和 :rules 即可。
- 基础规则如
"required"、"email"可内部转成标准 validator - 支持字段级异步校验,比如用户名唯一性检查,只需配置
asyncValidator函数 - 提交前调用
formRef.validate(),通过后再执行beforeSubmit钩子处理数据
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











