[AEM Forms]{class="badge positive" title="适用于AEM Forms)。"}

将表添加到自适应表单(核心组件) tables-in-adaptive-forms-core-components

版本
文章链接
AEM 6.5(核心组件)
单击此处
AEM as a Cloud Service(基础组件)
单击此处
AEM as a Cloud Service(核心组件)
本文

该功能在早期采用者计划下可用。 您可以使用官方电子邮件 ID 写信给 aem-forms-ea@adobe.com,加入早期采用者计划并申请使用该功能。

在自适应Forms中,使用表是呈现复杂结构化数据的有效方式。 政府和金融服务表单通常需要数字数据、行项目和多列输入的表格布局。

通过​ 自适应表单表 ​核心组件,您可以创作具有可配置行和列的响应式表、合并和拆分表行单元格、启用列排序、设置成比例的列宽以及在运行时添加或删除行。 本文介绍了如何在基于核心组件的自适应Forms中使用表组件。

NOTE
本文适用于基于​ 核心组件 ​的自适应Forms。 如果您使用Foundation组件创作表单,请参阅将表添加到自适应表单(Foundation组件)。

主要功能 key-capabilities

表核心组件支持以下功能:

  • 通过标题行和正文行进行结构化行和列创作
  • 具有辅助功能语义的列和行标题
  • 在运行时执行添加和删除操作的可重复行
  • 按升序和降序排序列
  • 为符合辅助功能,禁用对单个列的排序
  • 成比例的列宽
  • 合并和拆分表行单元格
  • 将默认文本框单元格替换为其他自适应表单组件
  • 将表数据绑定到表单数据模型
  • 使用规则编辑器在表行中进行计算
  • 在提交PDF (记录文档)中呈现表

与基础组件表比较 comparison-with-foundation-component-table

如果已使用基础组件表,则大多数表创作操作的工作方式都相同:添加行和列、合并和拆分表行单元格、设置列宽、启用排序以及添加可重复行。

与基础组件表相比,核心组件表添加或改进了以下内容:

功能
基础组件表
核心组件表
禁用对特定列的排序
不受支持
支持(符合辅助功能要求)
表格行中的计算
JavaScript表达式
可视规则编辑器,其函数为Sum、Min、Max和Average
表单数据绑定
XSD复杂类型、XDP表
JSON架构和表单数据模型绑定引用
提交PDF(记录文档)
Foundation组件指南
核心组件指南
组件属性
在创作对话框中记录
在自适应Forms核心组件文档中记录

表格结构 table-structure

将表组件添加到自适应表单时,Content​浏览器显示以下层级:

  • 表 — 根表容器

    • 标题行 — 每列包含一个标题单元格(例如,列1、列2、列3)
    • 第1​行、第2​行和其他行 — 每行都包含正文单元格

每个标题单元格和正文单元格都是单独的自适应表单组件。 默认情况下,标题单元格使用​ Text ​组件,正文单元格使用​ Text Box ​组件。 您可以在模板编辑器中配置不同的默认表结构,以便作者获得您定义的表布局和默认单元格组件。 有关详细信息,请参阅使用核心组件构建自适应表单模板。

创建表 create-a-table

  1. 打开基于核心组件的自适应表单进行编辑。
  2. 在​ 组件 ​浏览器中,找到​ 表 ​组件。
  3. 将​ Table ​组件拖动到表单画布上。

有关表组件属性,请参阅自适应Forms核心组件文档。

关于标题和正文单元格 about-header-and-body-cells

编辑标题标签

标题单元格是​ 文本 ​组件。 要更改列标题标签,请执行以下操作:

  1. 选择表格中的标题单元格。
  2. 在工具栏中选择​编辑。
  3. 更新标头标签。
  4. 单击​完成。

替换正文单元格组件

默认情况下,正文单元格是​ 文本框 ​组件。 您可以使用其他自适应表单组件替换正文单元格,如​数字输入、日期选取器​或​下拉列表:

  1. 选择要替换的正文单元格。
  2. 在工具栏中选择​替换。
  3. 选择要在单元格中使用的组件,如​Number Input。
NOTE
您可以在同一行的不同单元格中使用不同的组件类型。

添加或删除列 add-or-delete-a-column

添加或删除列:

  1. 在要修改的列中选择标题单元格。
  2. 在工具栏中选择​ 添加列 ​或​删除列。

添加列时,会在每行中添加一个新的标题单元格和相应的正文单元格。 删除列时,将删除该列中的标题单元格和所有正文单元格。

NOTE
不能从表中删除标题行。

添加、删除或移动行 add-delete-move-rows

添加、删除或移动行:

  1. 选择要添加、删除或移动行的行。

  2. 在工具栏中,选择以下操作之一:

    • 上移 — 将选定行上移。
    • 下移 — 下移选定行。
    • 添加行 — 在选定行下方添加一行。
    • 删除行 — 删除所选行。

合并和拆分表行单元格 merge-and-split-cells

您可以合并同一行中相邻的表行单元格,以创建跨越多列的单个单元格。

要合并表行单元格,请执行以下操作:

  1. 按住​Command (macOS)或​Control (Windows)并选择您要合并的相邻表行单元格。
  2. 在工具栏中选择​合并单元格。

要拆分合并的表行单元格,请执行以下操作:

  1. 选择合并的单元格。
  2. 在工具栏中选择​拆分单元格。

合并的表行单元格对于标签、子标题或跨行内多列的字段非常有用。

NOTE
不支持跨多列的行范围和标题单元格。 请参阅限制。

设置列宽 set-column-width

您可以在表配置对话框中使用逗号分隔值来设置成比例的列宽。

  1. 选择​ 表 ​组件。
  2. 在工具栏中选择​配置。
  3. 在​ 列宽 ​字段中,输入以逗号分隔的值列表。
  4. 单击​完成。

例如,对于包含三列的表,将2,4,6指定为​ 列宽 ​字段中的值可将第一列的宽度设置为2/12,将第二列的宽度设置为4/12,将第三列的宽度设置为6/12。 2/12,因为第一列的宽度是表格宽度的六分之一。 同样,4/12将第二列宽设置为表格宽度的三分之一,6/12将第三列宽设置为表格宽度的一半。

NOTE
这些值表示相对比例,而不是固定的像素宽度。

对列排序 sort-columns

您可以在运行时按列升序或降序对表数据排序。

排序适用于包含静态文本、数据模型属性或两者的组合的列。 可排序列中的正文单元格必须包含以下组件之一:数字输入、日期输入、日期选取器、文本​或​文本框。

对表启用排序

  1. 选择​ 表 ​组件。
  2. 在工具栏中选择​配置。
  3. 选择​启用排序。
  4. 单击​完成。
  5. 切换到​ 预览 ​模式。
NOTE
默认情况下启用排序。

在​ 预览 ​模式下,排序图标会显示在列标题中。 单击列标题可对值进行升序或降序排序。

禁用对特定列的排序

核心组件表支持禁用对单个列的排序。 当某些列不应进行排序时,这有助于满足辅助功能要求。

要禁用列的排序,请执行以下操作:

  1. 对表启用排序。
  2. 为应禁用排序的列选择标题单元格。
  3. 禁用该列的排序。

禁用了排序的列在运行时不显示排序控件。

动态添加或删除行 add-or-delete-rows-dynamically

当行配置为可重复时,表支持在运行时添加和删除行。

  1. 选择要使其可重复的表行。
  2. 在工具栏中选择​配置。
  3. 选择​ 重复面板 ​选项卡。
  4. 打开​使行可重复。
  5. 指定​ 最小重复次数 ​和​ 最大重复次数 ​以控制用户可以添加或删除的行实例数。
  6. 单击​完成。
  7. 切换到​ 预览 ​模式。

在运行时或在​ 预览 ​模式下,用户看到​ 添加 ​和​ 删除 ​按钮以添加或删除行实例。

有关可重复行为的详细信息,请参阅创建包含可重复部分(核心组件)的表单。

有关在创作表时的辅助功能指导,请参阅在HTML5表单中创建可访问的复杂表。

在表中使用计算 use-calculations-in-a-table

使用基于核心组件的自适应Forms的规则编辑器在表行中执行计算,如列总数或聚合值。

规则编辑器提供现成的函数,例如​Sum、Min、Max​和​Average,您可以将这些函数应用于表行和可重复面板中的字段。 有关示例,请参阅基于核心组件的自适应表单的规则编辑器示例。

在提交PDF中包含表 include-tables-in-submission-pdf

自适应表单表组件(如标题行和正文行)映射到生成的提交PDF(记录文档)中的相应组件。 您可以使用表格和面板布局设置配置表格在提交PDF中的显示方式。

有关更多信息,请参阅:

限制 limitations

使用核心组件创作表时,请记住以下限制:

  • 不支持​行范围。 可以在行内水平合并表行单元格,但不能在行间垂直合并。
  • 标题单元格不能跨越多个列。
  • 响应式移动布局,例如基础组件中可用的可折叠列和左上角的布局,计划在将来的核心组件表中提供。
  • 计划在将来的版本中提供表组件的​主题编辑器支持。 在提供主题编辑器支持之前,使用自适应表单主题。
  • 默认表中的每个正文单元格都有一个预定义的元素名称。 如果向表单中添加多个表,请重命名默认正文单元格元素名称以保持其唯一性,并避免在提交时丢失数据。

另请参阅 see-also

recommendation-more-help
experience-manager-cloud-service-help-main-toc