体验片段组件 experience-fragment-component

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

主题：
核心组件

创建对象：

开发人员
管理员
用户

使用核心组件体验片段组件，内容作者可以在支持本地化网站结构时，在页面上放置体验片段变体。

用途 usage

使用核心组件体验片段组件，内容作者可以从现有体验片段变体中选择并将其放在内容页面上。体验片段组件还支持本地化的网站结构。

组件的属性可在“配置”对话框中定义。
将组件添加到页面时的组件默认值可以在“设计”对话框中定义。

版本和兼容性 version-and-compatibility

体验片段组件的当前版本是 v2，此版本随 2022 年 2 月的核心组件发行版 2.18.0 的发布引入，具体说明见本文。

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

组件版本

AEM 6.4

AEM 6.5

AEM as a Cloud Service

兼容

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

本地化网站结构支持 localized-site-structure

体验片段组件可以适应本地化的网站结构，并根据页面的本地化渲染正确的体验片段。为此，体验片段必须满足以下条件。

模板中添加了体验片段组件。
该模板用于创建新的内容页面，这些页面是 /content/<site> 以下的本地化结构的一部分。
在内容页面上引用的体验片段属于 /content/experience-fragments 以下的本地化体验结构的一部分，遵循与 /content/<site> 以下的网站相同的模式，包括使用相同的组件名称。

在本例中，与当前页面具有相同本地化（语言、Blueprint 或实时副本）的片段将作为模板的一部分渲染。

此行为仅限添加到模板的体验片段组件。添加到单独内容页面的体验片段组件将渲染在页面中配置的准确体验片段再现。

有关体验片段组件本地化功能的工作方式示例，请参阅以下部分。
有关核心组件的本地化功能如何配合使用的示例，请参阅核心组件页面的本地化功能。

示例 example

假设您的内容与以下内容类似：

/content
+-- experience-fragments
   \-- wknd
      +-- language-masters
      +-- us
         +-- en
            +-- footerTextXf
            \-- headerTextXf
         \-- es
            +-- footerTextXf
            \-- headerTextXf
      \-- ch
         +-- de
            +-- footerTextXf
            \-- headerTextXf
         +-- fr
            +-- footerTextXf
            \-- headerTextXf
         \-- it
            +-- footerTextXf
            \-- headerTextXf
+-- wknd
   +-- language-masters
   +-- us
      +-- en
      \-- es
   +-- ch
      +-- de
      +-- fr
      \-- it
+-- wknd-events
\-- wknd-shop

请注意，/content/experience-fragments/wknd 以下的结构镜像了 /content/wknd 的结构。

在本例中，如果体验片段组件 /content/experience-fragments/wknd/us/en/footerTextXf 放在模板上，则根据该模板创建的本地化页面将自动渲染与本地化内容页面对应的本地化体验片段。

因此，如果您要导航到 /content/wknd/ch/de 下使用同一模板的内容页面，则将渲染 /content/experience-fragments/wknd/ch/de/footerTextXf 而不是 /content/experience-fragments/wknd/us/en/footerTextXf。