场景模式
除了文档页里的基础 demo,FormX 仓库还提供一个完整示例工程:
bash
pnpm --filter @formxjs/example-vue-ep-basic dev示例位置:
txt
examples/vue-ep-basic场景模式
| 场景模式 | 重点能力 |
|---|---|
| 能力全景 | 字段、容器、数组、远程资源、上传、自定义组件、运行时 patch。 |
| 配置型弹窗 | 多区块字段、编辑回填、异步详情、提交校验和重置。 |
| 控件覆盖 | 输入、选择、日期时间、层级选择、上传、只读展示和布局辅助。 |
| 动态数组 | field-group、增删复制、数组项作用域、行内校验。 |
| 远程资源 | optionsFrom、参数依赖、级联刷新、失败兜底。 |
| 运行时改写 | 通过 rulesV2 动态更新选项、props、可见性和默认值。 |
| 深层对象 | form-object、嵌套数组、跨层路径、派生字段。 |
| 流程分段 | 按步骤、状态、角色或模式组织字段区块。 |
| 矩阵录入 | 多行多列配置、批量项、动态必填和提交前校验。 |
为什么这些示例重要
简单动态表单只需要渲染字段。复杂业务表单需要处理:
- 多层值树。
- 数组项作用域。
- 远程资源和参数依赖。
- 跨字段、跨数组联动。
- 异步回填和提交校验。
- UI 皮肤与核心逻辑解耦。
这些模式能帮助使用者判断 FormX 是否适合自己的项目,而不是把 FormX 误解成某几个固定业务表单的实现。
建议阅读顺序
- 先看能力全景和控件覆盖,了解当前 Vue + Element Plus 皮肤支持什么。
- 再看动态数组和远程资源,理解
field-group、optionsFrom和参数依赖。 - 再看配置型弹窗和流程分段,理解复杂页面如何组织。
- 最后看深层对象和矩阵录入,理解作用域、规则图和提交校验。