[AEM Forms]{class="badge positive" title="适用于AEM Forms)。"}
将表添加到自适应表单(核心组件) tables-in-adaptive-forms-core-components
该功能在早期采用者计划下可用。 您可以使用官方电子邮件 ID 写信给 aem-forms-ea@adobe.com,加入早期采用者计划并申请使用该功能。
在自适应Forms中,使用表是呈现复杂结构化数据的有效方式。 政府和金融服务表单通常需要数字数据、行项目和多列输入的表格布局。
通过 自适应表单表 核心组件,您可以创作具有可配置行和列的响应式表、合并和拆分表行单元格、启用列排序、设置成比例的列宽以及在运行时添加或删除行。 本文介绍了如何在基于核心组件的自适应Forms中使用表组件。
主要功能 key-capabilities
表核心组件支持以下功能:
- 通过标题行和正文行进行结构化行和列创作
- 具有辅助功能语义的列和行标题
- 在运行时执行添加和删除操作的可重复行
- 按升序和降序排序列
- 为符合辅助功能,禁用对单个列的排序
- 成比例的列宽
- 合并和拆分表行单元格
- 将默认文本框单元格替换为其他自适应表单组件
- 将表数据绑定到表单数据模型
- 使用规则编辑器在表行中进行计算
- 在提交PDF (记录文档)中呈现表
与基础组件表比较 comparison-with-foundation-component-table
如果已使用基础组件表,则大多数表创作操作的工作方式都相同:添加行和列、合并和拆分表行单元格、设置列宽、启用排序以及添加可重复行。
与基础组件表相比,核心组件表添加或改进了以下内容:
表格结构 table-structure
将表组件添加到自适应表单时,Content浏览器显示以下层级:
-
表 — 根表容器
- 标题行 — 每列包含一个标题单元格(例如,列1、列2、列3)
- 第1行、第2行和其他行 — 每行都包含正文单元格
每个标题单元格和正文单元格都是单独的自适应表单组件。 默认情况下,标题单元格使用 Text 组件,正文单元格使用 Text Box 组件。 您可以在模板编辑器中配置不同的默认表结构,以便作者获得您定义的表布局和默认单元格组件。 有关详细信息,请参阅使用核心组件构建自适应表单模板。
创建表 create-a-table
- 打开基于核心组件的自适应表单进行编辑。
- 在 组件 浏览器中,找到 表 组件。
- 将 Table 组件拖动到表单画布上。
有关表组件属性,请参阅自适应Forms核心组件文档。
关于标题和正文单元格 about-header-and-body-cells
编辑标题标签
标题单元格是 文本 组件。 要更改列标题标签,请执行以下操作:
- 选择表格中的标题单元格。
- 在工具栏中选择编辑。
- 更新标头标签。
- 单击完成。
替换正文单元格组件
默认情况下,正文单元格是 文本框 组件。 您可以使用其他自适应表单组件替换正文单元格,如数字输入、日期选取器或下拉列表:
- 选择要替换的正文单元格。
- 在工具栏中选择替换。
- 选择要在单元格中使用的组件,如Number Input。
添加或删除列 add-or-delete-a-column
添加或删除列:
- 在要修改的列中选择标题单元格。
- 在工具栏中选择 添加列 或删除列。
添加列时,会在每行中添加一个新的标题单元格和相应的正文单元格。 删除列时,将删除该列中的标题单元格和所有正文单元格。
添加、删除或移动行 add-delete-move-rows
添加、删除或移动行:
-
选择要添加、删除或移动行的行。
-
在工具栏中,选择以下操作之一:
- 上移 — 将选定行上移。
- 下移 — 下移选定行。
- 添加行 — 在选定行下方添加一行。
- 删除行 — 删除所选行。
合并和拆分表行单元格 merge-and-split-cells
您可以合并同一行中相邻的表行单元格,以创建跨越多列的单个单元格。
要合并表行单元格,请执行以下操作:
- 按住Command (macOS)或Control (Windows)并选择您要合并的相邻表行单元格。
- 在工具栏中选择合并单元格。
要拆分合并的表行单元格,请执行以下操作:
- 选择合并的单元格。
- 在工具栏中选择拆分单元格。
合并的表行单元格对于标签、子标题或跨行内多列的字段非常有用。
设置列宽 set-column-width
您可以在表配置对话框中使用逗号分隔值来设置成比例的列宽。
- 选择 表 组件。
- 在工具栏中选择配置。
- 在 列宽 字段中,输入以逗号分隔的值列表。
- 单击完成。
例如,对于包含三列的表,将2,4,6指定为 列宽 字段中的值可将第一列的宽度设置为2/12,将第二列的宽度设置为4/12,将第三列的宽度设置为6/12。 2/12,因为第一列的宽度是表格宽度的六分之一。 同样,4/12将第二列宽设置为表格宽度的三分之一,6/12将第三列宽设置为表格宽度的一半。
对列排序 sort-columns
您可以在运行时按列升序或降序对表数据排序。
排序适用于包含静态文本、数据模型属性或两者的组合的列。 可排序列中的正文单元格必须包含以下组件之一:数字输入、日期输入、日期选取器、文本或文本框。
对表启用排序
- 选择 表 组件。
- 在工具栏中选择配置。
- 选择启用排序。
- 单击完成。
- 切换到 预览 模式。
在 预览 模式下,排序图标会显示在列标题中。 单击列标题可对值进行升序或降序排序。
禁用对特定列的排序
核心组件表支持禁用对单个列的排序。 当某些列不应进行排序时,这有助于满足辅助功能要求。
要禁用列的排序,请执行以下操作:
- 对表启用排序。
- 为应禁用排序的列选择标题单元格。
- 禁用该列的排序。
禁用了排序的列在运行时不显示排序控件。
动态添加或删除行 add-or-delete-rows-dynamically
当行配置为可重复时,表支持在运行时添加和删除行。
- 选择要使其可重复的表行。
- 在工具栏中选择配置。
- 选择 重复面板 选项卡。
- 打开使行可重复。
- 指定 最小重复次数 和 最大重复次数 以控制用户可以添加或删除的行实例数。
- 单击完成。
- 切换到 预览 模式。
在运行时或在 预览 模式下,用户看到 添加 和 删除 按钮以添加或删除行实例。
有关可重复行为的详细信息,请参阅创建包含可重复部分(核心组件)的表单。
有关在创作表时的辅助功能指导,请参阅在HTML5表单中创建可访问的复杂表。
在表中使用计算 use-calculations-in-a-table
使用基于核心组件的自适应Forms的规则编辑器在表行中执行计算,如列总数或聚合值。
规则编辑器提供现成的函数,例如Sum、Min、Max和Average,您可以将这些函数应用于表行和可重复面板中的字段。 有关示例,请参阅基于核心组件的自适应表单的规则编辑器示例。
在提交PDF中包含表 include-tables-in-submission-pdf
自适应表单表组件(如标题行和正文行)映射到生成的提交PDF(记录文档)中的相应组件。 您可以使用表格和面板布局设置配置表格在提交PDF中的显示方式。
有关更多信息,请参阅:
限制 limitations
使用核心组件创作表时,请记住以下限制:
- 不支持行范围。 可以在行内水平合并表行单元格,但不能在行间垂直合并。
- 标题单元格不能跨越多个列。
- 响应式移动布局,例如基础组件中可用的可折叠列和左上角的布局,计划在将来的核心组件表中提供。
- 计划在将来的版本中提供表组件的主题编辑器支持。 在提供主题编辑器支持之前,使用自适应表单主题。
- 默认表中的每个正文单元格都有一个预定义的元素名称。 如果向表单中添加多个表,请重命名默认正文单元格元素名称以保持其唯一性,并避免在提交时丢失数据。