Skip to main content

form_field

字段是由字段名、类型以及其它属性组成,不同的字段类型会以不同的组件形式展示,决定了内容的输入形式。

比如数字类型字段,就只允许输入数字。

字段名

我们应该确保一个表单中的字段名不要出现重复,因为后续在执行动作中引用字段时需要使用 {{@字段名}} 的语法进行引用。

描述

我们可以为字段设置描述信息,只需要在设置中启用 描述 开关即可

这些信息会展示在字段名下方,通常用于解释说明该字段的用途。

默认值

每个字段都可以设置默认值,最简单的方法就是在配置页面的组件中输入或选择一个值即可。

是否必填

如果勾选必填选项,那么表单提交时会自动检查该字段是否有输入或选择一个值,没有的话会阻止表单提交。

启用了必填项的字段,在字段名旁边会有一个红色的星号标记。

显示条件

显示条件可以帮助我们构建更加灵活且强大的表单,如果配置了显示条件的话,该字段只有在满足条件的情况下才会显示在表单界面。

比如我们有一个心情录入表单,我们可以配置当 心情 等于 开心 的时候,展示 记录 文本字段用于记录当前发生了什么事情让我们感到开心。

为了避免条件的循环依赖问题,顺序靠后的表单字段可以引用靠前的表单字段作为条件判断。

字段类型

不同的字段类型会以不同的组件展示,内容的输入形式也会有差异,可以根据试用场景按需配置。

文本

文本是最常用的一个字段类型,该字段类型以一个单行输入框展示,用户可以在输入框中输入任意的字符内容(不能换行)。

适用于一些短文本输入的场景,比如标题、姓名等

多行文本

多行文本是「文本」的扩展,该字段类型支持换行内容输入。

适用于一些长文输入场景,比如多个任务、无序列表等。

数字

数字字段也是以一个单行文本框体现,但是输入框限制了用户只能输入数值(支持小数点)。

适用于体重、身高、金额等纯数值内容的输入

日期时间

一个标准的日期时间输入框,用户可以在组件中选择「年、月、日、时、分」,最后的格式取决于用户的语言设置,比如 2025-01-01T00:00

默认值除了具体的某个时间点外,还支持设置「现在」,在提交的时候会自动取当前时间作为值提交。

日期

与「日期时间」类似,但是限定了用户只能输入「年、月、日」三个时间单位,比如 2025-01-01

同样支持将默认指出设置为「现在」

时间

与「日期时间」类似,但是限定了用户只能输入「时、分」两个时间单位,比如 10:00

同样支持将默认指出设置为「现在」.

开关

开关本质上和复选框是一样的,如果开启的话引用到的值是 true,关闭的话引用到的值是 false,适用于某些状态控制的场景。

下拉列表

下拉列表可以配置多个候选值,适合具有明确范围的内容输入,比如项目状态、用户性别等。

默认情况下下拉列表是单选,我们可以在设置中启用多选

如果你希望列表展示的名称和实际输出的值区分开的话,可以打开「启用自定义值」的开关,这样列表的编辑区单行就变成了两个输入框:第一列是选项名称,第二列是选项值。

单选框

单选框与下拉列表逻辑上大致相同,区别在于

  1. 单选框不支持多选
  2. 单选框的所有候选值是直接平铺展示出来的

密码

该类型与文本类似相似,都是单行输入框,但是输入的值会以 * 来代替,而不是明文展示。

文件路径

文件路径本质上也是下拉列表,可以配置单选或多选,但是插件将候选值自动设置为了全库的文件列表

该类型支持将文件自动转换成双链格式输出,只需要在设置中打开「转为内联」开关即可

属性值列表

属性值列表是一个特殊的类型,该类型需要配置一个「属性名」,插件会自动获取该属性在全库的值(去重)展示在候选列表中。

比如我们将属性名配置为 tags,那么候选列表中就是全库的所有标签值(非文本区域中的标签)