体验片段组件

核心组件体验片段组件允许内容作者在支持本地化站点结构的同时将体验片段变量放置在页面上。

使用

核心组件体验片段组件允许内容作者从现有体验片段变量中进行选择,并将其放置在内容页面上。 体验片段组件还支持本地化的站点结构。

本地化的站点结构支持

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

  • 体验片段组件会添加到模板。
  • 该模板用于创建新内容页面,该页面是/content/<site>下本地化结构的一部分。
  • 内容页面上引用的体验片段是/content/experience-fragments下的本地化体验片段结构的一部分,该结构遵循与/content/<site>下的站点相同的模式,包括使用相同的组件名称。

在这种情况下,具有与当前页面相同本地化(语言、蓝图或Live Copy)的片段将作为模板的一部分呈现。

此行为仅限于添加到模板的体验片段组件。 添加到单个内容页面的体验片段组件将呈现在组件中配置的确切体验片段再现。

  • 有关体验片段组件的本地化功能如何工作的示例,请参阅下面的部分。
  • 有关核心组件的本地化功能如何协同工作的示例,请参阅核心组件页面的本地化功能页面

示例

假设您的内容类似于:

/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

回退

体验片段组件将尝试按以下顺序查找相应的本地化组件。

  1. 首先,它试图找到语言根。
  2. 如果找不到,则会尝试查找蓝图。
  3. 如果找不到,它将尝试查找Live Copy。
  4. 如果找不到,则默认为组件中配置的体验片段。

版本和兼容性

体验片段组件的当前版本为v1,2019年9月随核心组件的2.6.0版引入了v1,该版本在本文档中进行了说明。

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

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

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

示例组件输出

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

技术详细信息

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

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

配置对话框

配置对话框允许内容作者选择应在页面上呈现的体验片段变量。

体验片段组件的编辑对话框

使用​打开选择对话框​按钮打开组件选择器以选择要添加到内容页面的体验片段组件变体。

如果您将体验片段组件添加到模板,请注意,如果体验片段已本地化,它将自动本地化,因此页面上呈现的内容可能与您显式选择的组件不同。 有关详细信 息,请参阅上面的示例。

您还可以定义​ID。 此选项允许控制HTML和数据层中组件的唯一标识符。

  • 如果留空,则会自动为您生成唯一ID,并可通过检查生成的页面找到该ID。
  • 如果指定了ID,则作者有责任确保它是唯一的。
  • 更改ID可能会影响CSS、JS和数据层跟踪。

设计对话框

设计对话框允许模板作者定义内容作者可以使用体验片段组件的选项以及放置体验片段组件时设置的默认值。

样式选项卡

体验片段组件支持AEM 样式系统

在此页面上