文档导航
表单设计:把字段搭成一张能用的表
在榕树里新建一张表单:从字段库挑字段、拖拽排布、配属性、保存与试填。
最后更新 2026年9月24日
一句话
表单设计就是「挑字段、排顺序、填属性」三件事,桌面端用所见即所得的三栏设计器完成。
在哪打开
侧边栏「表单」组里的「表单市场」是表单的总入口。在列表右上角点「新建」进入编辑器,已有表单在卡片上点「编辑」或「复制」。编辑器顶部有三个模式标签:「字段设计」「工作流」「设置」,打开时停在「字段设计」。
主要动作
- 新建:点「新建」直接进编辑器→ 结果:打开一张空白表单(未登录会先弹登录)。
- 加字段:把左栏字段库里的字段拖到中间画布,落在卡片上半区就插在它前面、下半区就插在后面→ 结果:画布多出一张字段卡片并被自动选中;也可以直接点字段库条目,追加到末尾。
- 排字段:拖动画布上的卡片换位置→ 结果:画布顺序就是填表时的实际顺序。
- 复制 / 删除字段:用卡片上的复制、删除按钮→ 结果:复制出来的字段标识会自动带
_copy后缀避免重名。 - 配属性:点中卡片,右栏出现「基础 / 显示 / 校验」三组→ 结果:改动即时反映到画布预览上。
- 保存:点右下角常驻的「保存」按钮,或按 Ctrl/Cmd+S→ 结果:提示「保存成功」并回到列表;限制(表单名称必填、至少要有 1 个字段、每个字段的标识/名称/类型都不能空,不满足时只提示、不保存)。
字段 / 状态说明
| 名称 | 含义 | 什么时候用 |
|---|---|---|
| 字段库分组 | 左栏把字段按「输入 / 选择 / 日期时间 / 结构 / 上传签名 / 特殊 / 布局」分组 | 找某类字段时按组浏览 |
| 字段标识(ID) | 字段在提交数据里的键 | 需要跟工作流表达式、数据记录对上字段时 |
| 字段名称 | 填表人看到的标签 | 给人看的文案 |
| 字段类型 | 单行文本、数字、单选、上传等共 41 种 | 换类型会连带换掉可配置项 |
| 提示文字 | 字段下方的填写说明 | 需要解释怎么填 |
| 默认值 | 新建填写时的初始值 | 多数人填同一个值 |
| 必填 | 「校验」组里的开关,打开后不填不让提交 | 关键信息 |
| 选项列表 | 单选/多选/下拉的候选项 | 选择类字段 |
| 表单状态 | 草稿 / 已发布 / 暂停 / 作废,只在「设置」模式里改 | 决定表单能不能被市场收进去 |
与其它功能的关系
- 字段就是「工作流」模式里能引用的输入:表达式的辅助面板会把表单字段列成可点击插入的
input.<字段标识>。 - 在「设置」里把表单配成 CDN 场景后,要填的「唯一访问 key」就是这张表单公开地址的末段。
- 设计器没有自动保存:不点保存就关掉,这次改动什么都不写。
限制与注意
- 字段类型不是永远全都在:左栏会按后端下发的字段目录,把当前环境不可用的类型禁用(正式环境禁用文件存储类字段),目录拉不到时全部放行。
- 分类标签最多选 5 个,满了以后其余条目置灰。
- 表单描述限 200 字。
- 「上传-多文件 / 上传-单文件 / 上传-单图 / 签名」在正式环境不可用,这是后端按环境禁用的结果,不是设计器坏了。
常见问题
Q:画布上看到的就是最终效果吗? A:是。画布用带禁用感的控件把每个字段渲染出来,所见即所得;想真走一遍流程,去列表点「填写」。
Q:点了保存怎么还在编辑器里? A:只有保存成功才会回到列表;有必填项没填时会原地提示,比如「请输入表单名称」「请至少添加一个字段」。
Q:字段标识能随便改吗? A:能改,但它是数据里的键;改了之后引用它的工作流表达式不会自动跟着更新。
Q:怎么把别人的表单变成我自己的? A:在列表卡片上点「复制」,副本归你;从官方表单复制出来的副本不会继承官方的 CDN 刷新地址。