内容片段列表组件

核心组件内容片段列表组件允许显示内容片段的列表。

使用

核心组件内容片段列表组件允许在基于内容片段模型的页面上包含内容片段列表。 这对于创建无标题内容特别有用,这些内容可以被其他应用程序轻松使用。

版本和兼容性

内容片段组件的当前版本为v1,该版本在2019年5月随核心组件2.4.0版引入,在本文档中进行了描述。

下表详细列出了组件的所有受支持版本、组件版本与之兼容的AEM版本,以及指向以前版本文档的链接。

组件版本 AEM 6.4 AEM 6.5 AEM as a Cloud Service
v1 兼容 兼容 兼容

有关核心组件版本和版本的更多信息,请参阅文档核心组件版本

组件输出示例

要体验内容片段列表组件并查看其配置选项以及HTML和JSON输出的示例,请访问组件库

技术详细信息

有关内容片段列表组件的最新技术文档可在GitHub上找到。

有关开发核心组件的更多详细信息,请参阅核心组件开发人员文档

配置对话框

配置对话框允许内容作者定义构成列表的内容片段以及要包含的这些片段的元素。

“属性”选项卡

属性​选项卡定义列表中包含的内容片段。 这主要基于选定的内容片段模型,但还有其他可用的过滤器选项。

内容片段列表组件的编辑对话框的属性选项卡

  • 模型 — 列表所基于的内容片段模型的路径。
    • 默认情况下,定义为​模型路径​的模型的所有内容片段都包含在列表中。
  • 父路径 — 应从中生成列表的父路径。
    • 基于所选​模型路径​的内容片段将被过滤为指定​父路径​上的内容片段。
      • 单击或点按字段右侧的​打开选择对话框​按钮以指定路径。
  • 标记 — 列表中将仅包含具有指定标记的内容片段。
    • 单击或点按字段右侧的​打开选择对话框​按钮以指定标记。
    • 单击或点按选定标记旁边的X可删除这些标记。
  • 排序依据 — 内容片段模型的字段,列表将按该字段进行排序
    • 只能选择文本字段(包括数字、日期和时间)。
  • 排序顺序 — 如何按顺序字段对列表
    • 升序或降序
  • 最大项目数 — 要在列表中显示的项目数上限
    • 没有值将返回所有项目。
  • ID — 利用此选项,可控制HTML和数据层中组件的唯一标识符 的唯一标识符
    • 如果留为空白,则会自动为您生成唯一ID,并且可以通过检查生成的页面找到该ID。
    • 如果指定了ID,则作者有责任确保该ID是唯一的。
    • 更改ID可能会影响CSS、JS和数据层跟踪。
注意

排序依据排序顺序​和​最大项目​选项在核心组件2.7.0版中引入。

“元素”选项卡

默认情况下,内容片段模型的所有元素都将包含在列表中(除非受​最大项目​字段的限制)。 元素​选项卡允许您仅指定要包含的特定元素。

内容片段列表组件编辑对话框的元素选项卡

  • 元素 — 将仅显示指定列表中内容片段的元素。
    • 单击或点按​添加​按钮以添加新元素。
    • 单击或点按​删除​按钮以删除选定的元素。
    • 拖动​Order​句柄以重新排列元素的顺序。

“设计”对话框

设计对话框允许模板作者定义应用于内容片段列表组件的样式。

在此页面上