动作类型详解

配置分组(Section):把动作表单整理得井井有条

当动作的参数越来越多,表单就会又长又乱。配置分组(section)能按逻辑把参数归组、分栏、加说明,还能折叠与按条件显示,让表单只在恰当的时刻露出恰当的字段。

原文 Palantir Foundry · Action types 预计阅读 9 分钟 互动演示 + 5 道测验
本文来源 · Source 内容整理自 Palantir Foundry 官方文档:
https://www.palantir.com/docs/foundry/action-types/configure-sections/
原始标题:Configure sections

一句话速览

配置分组(Section):把动作表单整理得井井有条:当动作的参数越来越多,表单就会又长又乱。配置分组(section)能按逻辑把参数归组、分栏、加说明,还能折叠与按条件显示,让表单只在恰当的时刻露出恰当的字段。

1 配置分组(section)
动作表单(action form)可以用 sections(配置分组)来定制
2 添加一个分组
在 Form 标签页,点击 Add section(添加分组)
3 用列布局(columns)节省空间
你可以把参数组织在列里,更好地利用表单空间,或把相关参数靠得更近
4 把参数放进分组
有两种办法把参数加进 section:从分组配置视图(section configuration view)里加,或从 Form 标…
1

什么是配置分组(section)

先建立一个整体印象:分组是表单的"收纳盒"。

动作表单(action form)可以用 sections(配置分组)来定制。一个 section 提供对参数的逻辑归组(logical grouping),把相关的字段摆在一起,让填写的人一眼看懂该填什么。

除此之外,section 还支持三件有用的事:分栏(columns)说明(descriptions)、以及条件覆盖(conditional overrides)。也就是说,分组不只是"圈一块地",它还能控制内部字段怎么排、说什么、以及什么时候出现。

提示:分组里的这些能力(折叠、隐藏、条件覆盖)会一并作用在它包含的每个参数上——组合起来,就能做出"聪明"的表单:只在合适的情境下才展示需要的字段。
2

如何添加一个分组

在 Form(表单)标签页里开启一个分组。

Form 标签页,点击 Add section(添加分组)。这会打开一个详细的配置弹窗,你可以在其中:

  • 填写分组的标题(title);
  • 选择列布局(column layout,单列或双列);
  • (可选)写一段面向用户的说明(description)。

这里有个容易记混的细节:分组的说明不做任何样式修饰,而且与"参数说明"不同——它会始终显示在分组内部,而不是藏在 tooltip(悬停提示)里。

"The description is not stylized and, unlike parameter descriptions, will always be shown in the section itself, not in a tooltip."说明不做样式修饰,且始终显示在分组内部,而非 tooltip。
3

用列布局(columns)节省空间

单列太长?用双列把紧凑的字段并排摆。

你可以把参数组织在里,更好地利用表单空间,或把相关参数靠得更近。一个 section 最多能被分成 一列或两列(one or two columns)

当某些参数本身占用空间不大时,把它们分到独立的列里特别有用——既省纵向空间,阅读也更顺。

动手试:切换 section 的列数
参数 A
占用空间小的字段适合并入同一列。
参数 B
并排摆放,纵向更紧凑。
参数 C
两列布局让表单更短。
参数 D
相关字段靠得更近。
4

把参数放进分组

两种加入方式:在分组里新建/移入,或在 Form 里拖拽。

有两种办法把参数加进 section:从分组配置视图(section configuration view)里加,或从 Form 标签页里加。

方式一在分组配置视图里操作
在分组配置视图点击 Add new parameter(添加新参数)来配置;或点击 Add existing parameter(添加已有参数)把现有参数移入。
适合从零规划一个分组的字段构成,能直接在该视图内完成新参数的配置。
方式二在 Form 标签页里拖拽
Form 标签页把各分组及其参数列在一个总览里;按住参数左侧的"八点"手柄拖入已有分组即可。
参数和分组的显示顺序,取决于它们在 Form Content(表单内容)里的排序——拖到哪,就显示到哪。
点击此处,回顾两种加入方式。
5

折叠、隐藏与条件显示

让表单"该藏就藏、该现就现"。

分组可以折叠(collapsible),也可以整体隐藏(hidden),还能使用条件覆盖(conditional overrides),给你更多定制表单行为的方式。所有这些特性同样会作用到分组内部的参数上。

组合使用这些能力,就能做出更聪明的表单:例如一个分组可以先藏起来,只有当用户先填了某个前置参数后,才把它显示出来。这样表单不会一次把所有字段砸到用户脸上。

注意:分组内部参数的顺序、是否必填等,都会受到分组特性的影响;调整分组时,记得一并检查里面的参数表现。
一个 section 最多可以分成几列?点击揭晓。

一页带走

① 分组即"收纳盒"
section 对参数做逻辑归组,支持分栏、说明与条件覆盖。
② 说明常驻组内
section 说明不做样式修饰、始终显示在内部,而非 tooltip。
③ 两种加参方式
分组配置视图里 Add existing parameter,或在 Form 中拖拽八点手柄。
④ 该藏就藏
分组可折叠、隐藏,并基于前置参数条件显示,做更聪明的表单。

延伸阅读 · 相关页面

按主题横向跳转,不必顺着目录一篇篇读。

常见问题速答 · FAQ

关于「配置分组(Section):把动作表单整理得井井有条」,读者最常问的几个问题。

什么是配置分组(section)?
动作表单(action form)可以用 sections(配置分组)来定制。一个 section 提供对参数的逻辑归组(logical grouping),把相关的字段摆在一起,让填写的人一眼看懂该填什么。
如何添加一个分组?
在 Form 标签页,点击 Add section(添加分组)。这会打开一个详细的配置弹窗,你可以在其中。
用列布局(columns)节省空间是什么?
你可以把参数组织在列里,更好地利用表单空间,或把相关参数靠得更近。一个 section 最多能被分成 一列或两列(one or two columns)。
把参数放进分组是什么?
有两种办法把参数加进 section:从分组配置视图(section configuration view)里加,或从 Form 标签页里加。