在线示例总览
36 个在线示例是平台表单运行时的「样板间」：控件怎么落库、表格能玩出多少花样、校验能严到什么程度、导入导出有哪些策略，每个知识点都有一个可点可改的活例子。本页给出总矩阵与阅读路线，细节分到四篇专题。
功能在哪
- 菜单路径：基础设施 → 在线示例，下挂 36 个叶子菜单
- 每个示例打开的都是表单运行时页面，路由形如
/infra/form-demo/form-design-run/<示例编码> - 示例本身即「表单设计 → 发布 → 生成菜单」这条链路的产物（见表单设计与表单运行时），看示例等于在看你自己将来页面的全部可能
示例数据可以随便动
每个示例背后是一张独立演示表（test_demo_* 等），增删改只影响示例本身；行内 变更记录 还能回看每次改动。放心点，点坏了正是学习的一部分。
阅读路线
| 顺序 | 专题 | 回答的问题 |
|---|---|---|
| 1 | 控件与联动 | 有哪些控件？下拉选项、跨表带数、主子表、左树 / 页签 / 行内编辑怎么配 |
| 2 | 表格呈现 | 列格式化、冻结、多级表头、合计、合并、分组、树形、打印、列设置 |
| 3 | 校验体系 | 格式 / 跨字段 / 联动 / 唯一性 / 子表 / 脚本 / 服务端扩展点七层校验 |
| 4 | 导入导出 | 表头匹配、字典反查、主子表导入、按业务键覆盖、重复策略 |
36 例总矩阵
| 示例 | 分组 | 看点 |
|---|---|---|
| 控件总览示例 | 控件 | 受支持的控件各放一份，覆盖 scalar / delimited / none 三种落库形态 |
| 控件数据接口示例 | 控件 | 下拉选项来自一条无入参的数据接口，不用填 URL 也不用写解析函数 |
| 接口参数取字段示例 | 控件 | 接口入参取自表单上另一个字段：选了部门，人员下拉跟着变 |
| 客户档案示例 | 控件 | 被「跨表取数」与「销售订单」关联引用的客户档案主数据 |
| 跨表取数示例 | 控件 | 选一条客户档案，把等级、联系人、电话带到合同上（服务端重读覆盖） |
| 销售订单示例 | 控件 | 主子表 + 子表合计 + 公式 + 打印模板 + 变更记录，最接近真实单据 |
| 列表标签页示例 | 控件 | 按任务状态把列表切成几个页签，切页签等价于追加一个等值查询条件 |
| 列表行内编辑示例 | 控件 | 点编辑不弹窗，就地改这一行并单独保存，适合一屏改一批价格 |
| 列表左侧树示例 | 控件 | 列表左边挂一棵区域树，点节点按区域筛数据 |
| 表格示例1-基础与列格式化 | 表格 | 十一种列格式化各摆一列，对比同一个值配不同格式化长什么样 |
| 表格示例2-冻结列与宽表 | 表格 | 34 列横向滚动；左固定编号与名称、右固定操作列；两种宽度类型对比 |
| 表格示例3-多级分组表头 | 表格 | 五组两级表头；固定列不能参与分组，故本示例一列都不固定 |
| 表格示例4-合计行与明细合计 | 表格 | 主表列与明细列两种合计口径；合计行跟随列自己的格式化 |
| 表格示例5-主子表展开与跨行合并 | 表格 | 两张明细表同时展开、主表列纵向合并；行数不等短表留空 |
| 表格示例6-同值单元格合并 | 表格 | 三列级联合并、空值不合并；必须配默认排序，同值不相邻合并不了 |
| 表格示例7-行分组与分组小计 | 表格 | 分组行带条数与两列小计、可折叠；分组按值归并不依赖排序 |
| 表格示例8-树形台账（WBS） | 表格 | 四层自关联建树，树形与合计并用；树形与分页互斥 |
| 表格示例9-左侧树与标签页双维筛选 | 表格 | 左侧按类型浏览 + 顶部按状态切页签，两个维度是「与」的关系 |
| 表格示例10-行内编辑与批量操作 | 表格 | 数字 / 下拉 / 日期 / 开关四种行内编辑器；批量删除、导出、变更记录 |
| 表格示例11-表格打印 | 表格 | 列表打印所见即所得；单据打印用行标记 {#子表} 按条数重复明细行 |
| 表格示例12-富展示单元格与列设置 | 表格 | 图片 / 签名 / 附件 / 超链接 / 标签五种非文本列；列设置存浏览器本地 |
| 复杂表头主子表示例 | 表格 | 相邻几列归到父表头下；明细列把一条主记录摊平成多行 |
| 树形表格示例 | 表格 | 自关联建树；树形与分页互斥，分页会把子行推到下一页导致它从树里消失 |
| 校验示例1-格式校验大全 | 校验 | 内置正则库 18 项全覆盖，外加自定义正则、多规则叠加、自定义提示 |
| 校验示例2-必填与跨字段 | 校验 | 七条跨字段约束：断言、字段间比较、BETWEEN、IN、开关触发、金额勾稽等 |
| 校验示例3-联动动态校验 | 校验 | 联动十种动作全覆盖；含 otherwise A/B 对照；SUBMIT 时机服务端兜底 |
| 校验示例4-唯一性长度与脱敏 | 校验 | 字段唯一性（叠加数据库唯一索引）、长度守卫、五种脱敏策略 |
| 校验示例5-子表明细校验 | 校验 | 子表行数区间、行内必填与格式、行号合并报错；公式服务端权威重算 |
| 校验示例6-提交前脚本 | 校验 | 前端脚本四钩子全覆盖：默认值、即时提示、提交前校验与二次确认 |
| 校验示例7-服务端扩展点 | 校验 | 身份证校验码、查库查重、工号生成、转正后禁改、禁删；addError 汇总返回 |
| 导入导出示例1-基础单表 | 导入导出 | 表头按名字匹配、字典标签反查、单元格取值、逐行错误报告、三种导出值模式 |
| 导入导出示例2-主子表导入 | 导入导出 | 明细行按主记录相邻合并；父键必须有序；导出摊平或分 sheet |
| 导入导出示例3-按业务键覆盖导入 | 导入导出 | 按供应商编码 upsert；三种重复策略；文件内自重复识别；预览令牌一次性 |
| 全控件验证表单 | 探针 | 内部回归验证页，当前为空态，普通阅读可跳过 |
| 查看明文验证 | 探针 | 脱敏字段明文查看的内部验证页，当前为空态 |
| 测试-反例状态列类型错 | 探针 | 状态列类型配错的反例留档，当前为空态 |
三个探针页为什么是空的
「全控件验证表单 / 查看明文验证 / 测试-反例状态列类型错」是开发期回归验证与反例留档页：菜单在、页面打开为空态（无列表无表单）。它们出现在菜单里是为了让验证入口可直达；普通用户阅读矩阵时跳过这三行即可。
通用操作约定
所有示例页共用运行时的操作语言，先记住这一套，四篇专题里不再重复：
| 位置 | 控件 | 作用 |
|---|---|---|
| 查询区 | 搜索 / 重置 | 按该示例配置的查询条件过滤；重置清空 |
| 查询区 | 展开(n) | 查询条件较多时折叠 / 展开全部条件 |
| 工具栏 | 新增 | 打开新增表单（对话框或抽屉） |
| 工具栏 | 导出 / 批量打印 | 视示例配置出现；导出走导入导出专题的策略 |
| 行操作 | 编辑 / 详情 | 编辑可写、详情只读 |
| 行操作 | 变更记录 | 回看该行数据的历次修改（数据日志） |
| 行操作 | 删除 / 更多 | 删除为逻辑删除；更多收纳低频操作 |
视角对照
| 视角 | 能看到什么 |
|---|---|
| 租户管理员（docadmin） | 本租户全部 36 个示例菜单与演示数据，本章截图视角 |
| 超级管理员 | 同样 36 个菜单；示例数据按租户隔离，看到的是各租户自己的演示表 |
| 普通员工类角色 | 视套餐与授权而定，可能只看到部分示例菜单（菜单本身也受授权管控） |
进阶
- 把示例变成自己的页面：在表单设计列表找到同名设计 → 复制一份 → 改绑自己的数据表 → 发布生成菜单，即得一个「示例同款」业务页。
- 示例 ↔ 设计器对照读：任何示例页的效果存疑时，去设计器打开对应设计看配置（列格式化、校验规则、联动都在那里），比猜界面快。
- 变更记录是教学工具：改一条数据前后各看一眼变更记录，能直观理解服务端重算、脱敏、upsert 等动作实际写了什么。
- 空态示例的读法：控件总览示例当前列表无数据（空态），它的价值在设计配置——去设计器打开看控件全貌，或在别的示例里看同类控件的活体表现。
常见问题
为什么某个示例打开是空的？ 两种情况：演示表本就无数据（如控件总览），或该页是探针 / 反例留档页（见矩阵 info 框）。空态不影响其他示例。
示例数据能删光吗？ 能，但删完页面即空态；需要恢复时按示例编码重新造数，或联系管理员。学习阶段建议留几条做对照。
示例和「在线开发」里的表单设计是什么关系？ 示例是设计 + 发布后的运行产物；在线开发管设计与发布，在线示例管运行效果展示。同一套运行时引擎。
为什么有的示例没有导出 / 批量打印按钮？ 按钮按设计配置出现：未配导出策略或打印模板的示例不显示对应按钮。导入导出专题的三个示例按钮最全。
示例页能当真实业务页用吗？ 不建议。演示表结构与数据均为教学用途；真实业务请新建设计并绑定自己的数据表。