Vue 3动态表单配置项导入导出核心是抽象为可序列化JSON Schema格式;导出时遍历components生成含type、label、model、props、rules及children的结构化数据并保存为文件;导入时需校验结构、过滤不支持组件、确保注册完成后再更新配置。

Vue 3 动态表单的配置项导入与导出,核心是把表单结构抽象为可序列化的数据(如 JSON Schema 或自定义配置对象),再通过前端能力完成读取、解析、生成和保存。不依赖后端也能跑通全流程,关键在数据格式统一和组件映射清晰。
配置项导出:从 formConfig 生成标准结构
导出本质是把当前画布上的组件列表转成结构化数据。推荐使用 JSON Schema 兼容格式,便于跨平台复用:
- 遍历
formConfig.components,对每个组件提取type、label、model、props(含required、placeholder等)和校验规则rules - 嵌套结构(如分组、子表单)用
children字段递归表达,保持层级语义 - 导出按钮触发时,调用
JSON.stringify(config, null, 2),再用FileSaver.js保存为form-schema.json
配置项导入:加载 JSON 并安全还原渲染
导入不是简单 JSON.parse 后直接赋值,需做校验和降级处理:
- 先检查 JSON 根结构是否含
components数组,字段是否包含必需的type和model - 遍历导入项时,过滤掉当前项目不支持的组件类型(比如 JSON 里有
rich-editor,但本地只注册了input/select),跳过或提示 - 用
watch或nextTick确保组件注册完成后再更新formConfig,避免:is渲染失败
配套功能增强实用性
纯 JSON 导入导出够用,但加几个小功能会明显提升体验:
立即学习“前端免费学习笔记(深入)”;
-
模板下载:提供「默认表单模板」JSON 文件供用户参考,内容含常用字段+基础校验,命名如
basic-form-template.json -
版本标识:在导出 JSON 中加入
schemaVersion: "1.2"字段,后续升级组件时可做兼容判断 -
代码导出联动:导出 JSON 的同时,提供「导出 Vue 组件」按钮,用模板字符串拼出带
<template></template>和<script setup></script>的 SFC 文件
注意事项与常见坑
实际落地时容易忽略的细节:
- 日期/时间类组件的
props.format在 JSON 里是字符串,导入后需手动转换为 Date 对象或保留字符串由组件内部处理 - 函数类配置(如自定义校验
validator)无法序列化,导出时应剔除或转为字符串描述,导入时需重新绑定 - 如果用了异步组件(
defineAsyncComponent),导入后首次渲染可能触发 loading 状态,建议加骨架屏或延迟显示


















