内容片段组件 content-fragment-component

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

利用核心组件内容片段组件，可以显示内容片段。

NOTE

在版本 2.4.0 的核心组件之前，内容片段组件作为核心组件的扩展提供，并且必须单独下载并明确启用。

用途 usage

利用核心组件内容片段组件，可以包含页面上的内容片段。

内容片段组件的当前版本是 v1，此版本随 2017 年 10 月的核心组件 1.1.0 版的发布引入，具体说明见本文。

下表详细说明了该组件的所有受支持版本、与该组件的版本兼容的 AEM 版本以及指向早期版本文档的链接。

组件版本

AEM 6.4

AEM 6.5

AEM as a Cloud Service

与
版本 2.17.4 和更低版本兼容

兼容

NOTE

在版本 2.4.0 之前，内容片段组件位于 extensions 文件夹中。

apps/core/wcm/extension/components/contentfragment/v1/contentfragment

从版本 2.4.0 开始，该组件已移至以下位置。

apps/core/wcm/components/contentfragment/v1/contentfragment

虽然两者都是 v1，但在升级到版本 2.4.0 或更高版本的核心组件时，从 extensions 文件夹中使用的任何内容片段组件都需要迁移其相关代理组件才能使用新的资源类型。

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

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

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

在核心组件开发人员文档中可找到有关开发核心组件的其他详细信息。

利用“配置”对话框，内容作者可以定义要包含的内容片段及其元素。

内容片段组件

内容片段
- 所需内容片段的路径
- “选择”对话框 可用于定位片段
显示模式
- 单个文本元素 - 允许选择一个多行文本元素并启用段落控制选项
- 多个元素 - 允许选择选定的内容片段的一个或多个元素
元素 - 要包含的内容片段的一个或多个元素
变体 - 要使用的内容片段的变体（默认为 Master）
段落
- 全部 - 显示所有段落
- 范围
  - 指定应显示的段落的范围（用分号分隔）
  - 例如，如果为 1;3-5;7;9-*，则包含第一段、第三段到第五段、第七段、第九段到最后一段
ID - 利用此选项，可以控制 HTML 和 Data Layer 中的组件的唯一标识符。
- 如果留空，系统会自动为您生成一个唯一 ID，可以通过检查结果页面找到该 ID。
- 如果指定一个 ID，作者有责任确保它是唯一的。
- 更改此 ID 会对 CSS、JS 和 Data Layer 跟踪产生影响。