表单|飞书低代码平台 - 飞书官网
产品功能

表单|飞书低代码平台

飞书

2024-12-23

概述​
使用说明​
概述​
表单的核心作用是数据收集,即涉及到填写数据的场景都可以使用表单,例如活动报名、物料申请、资料变更、搜索框,并支持将收集的数据记录提交入库。​
页面的表单组件与流程触发器节点的表单有什么区别:​
​
表单​
页面的表单组件​
流程的触发器表单​
图示​
​
250px|700px|reset
​
​
​
​
250px|700px|reset
​
​
​
250px|700px|reset
​
​
特点​
  • 搭建能力好,可定制每个原子组件的样式和事件动作​
  • 可复用,复制粘贴方便​
  • 能够使用页面的其他组件,如图片、按钮、表格​
  • 跟随流程,配置方便​
  • 支持多个数据对象​
适用场景​
有一定的页面样式要求,想要定制组件样式,如活动报名单、员工信息登记页等。​
​
250px|700px|reset
​
​
有较多流程分支和操作,如物料变更、审批等。​
​
250px|700px|reset
​
​
​
数据源​
一个表单仅能绑定一个数据源​
一个表单可关联多个数据源​
​
使用说明​
(一)配置属性​
​
属性​
配置说明​
对象​
表单绑定的数据源​
关联记录​
用于查看或编辑已有记录,比如传入表格的点击行,可使表单查看/编辑点击的表格明细行​
​
250px|700px|reset
​
​
字段​
用于管理表单的数据源字段,添加字段后表单会根据字段自动生成对应的输入组件。​
  • 目前已支持的字段有:文本、多语文本、富文本、整数、浮点数、定点数、日期、日期时间、手机号码、邮箱、选项、布尔、头像/标识、行政区划、文件、关联对象​
  • 暂未支持的字段为:子对象、自动编号、公式、汇总、引用字段、多值取单值​
表单字段的数量上限为 50。​
状态​
支持只读/禁用状态​
  • 当表单开启只读/禁用时,表单内所有输入组件均为只读/禁用状态。​
  • 同时开启只读和禁用时,表现为禁用。​
  • 支持通过 fx 配置条件,计算结果为 true 时开启,为 false 时关闭。​
表单布局​
表单是一个复合组件,默认带有三个插槽:​
  • 顶部区:默认会添加文本组件作为标题​
  • 内容区:用于添加输入组件​
  • 底部区:默认添加按钮组件,可定义按钮用途,见表单方法​
顶部区和底部区插槽可关闭​
​
250px|700px|reset
​
​
显隐设置​
配置表单组件的显示时机​
​
(二)设计样式​
支持对整个表单组件的尺寸、间距、位置、背景、边框和阴影样式进行设置​
样式设置细节说明,点击查看:页面布局与样式设计 ​
(三)事件动作​
如果要流转表单填写的数据,比如在数据库新增记录,需要定义表单提交时的事件动作。可通过新增记录或更新记录,快速实现表单的新增或编辑场景。​
  • 新增记录:选择表单对应的数据源,在变量中填入该表单的表单值(表单组件暴露有表单值,为记录类型的动态数据,由内部输入组件的值构成)。配置完成后,在运行态表单录入数据,提交,即可在数据库里新建一条数据记录。​
​
250px|700px|reset
​
​
​
  • 更新记录:同上,选择数据源和变量,注意,更新记录场景需要表单有关联记录。配置完成后,在运行态对表单关联的记录进行修改,提交,即可在数据库里修改该记录。​
​
250px|700px|reset
​
​
(四)表单方法​
表单暴露有提交、重置、清空三个组件方法,可通过按钮进行调用。​
  • 提交按钮,用于提交表单。​
  • 重置按钮,将表单内容恢复到初始态。若字段配有默认值,则点击后字段内容重置为默认值;若没有默认值,则重置为空。​
  • 清空按钮,将表单的字段内容清空。​
​
250px|700px|reset
​
​
(五)字段与输入组件​
输入组件是表单的核心内容,用以收集不同的数据类型。输入组件与数据源字段的对应关系如下:​
​
表单输入组件​
数据源字段​
文本输入​
文本​
数字输入​
整数、浮点数、定点数​
下拉选择​
关联对象、选项​
单选框​
关联对象(单条)、选项(单选)​
复选框​
关联对象(多条)、选项(多选)​
日期​
日期​
日期时间​
日期时间​
开关​
布尔​
手机号​
手机号码​
邮件​
邮箱​
富文本​
富文本​
文件​
文件​
头像​
头像 / 标识​
行政区划​
行政区划​
多语文本​
多语文本​
​
如何添加输入组件:​
  • 表单添加字段,会自动生成对应的输入组件​
​
250px|700px|reset
​
​
  • 拖入输入组件,绑定指定字段​
​
250px|700px|reset
​
​
预约飞书企业效能顾问 深度诊断企业痛点,定制专属 AI 办公方案

先进团队,先用飞书

欢迎联系我们,飞书效能顾问将为您提供全力支持
分享先进工作方式
输送行业最佳实践
全面协助组织提效
标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题

字节跳动旗下 AI 工作平台

联系我们立即试用