电子邮件体验片段组件 email-experience-fragment-component
电子邮件体验片段组件允许内容作者在其内容中放置体验片段变体,同时支持本地化的内容结构。
用途 usage
电子邮件体验片段组件允许内容作者从现有的体验片段变体中进行选择,并将其放置在内容中。体验片段是一组内容,包括内容和布局,并且可以跨渠道重复使用。
电子邮件体验片段组件支持本地化的网站结构。
版本和兼容性 version-and-compatibility
电子邮件体验片段组件的当前版本是 v1,此版本随 2022 年 10 月的电子邮件核心组件发行版本 X 的发布引入,具体说明见本文档。
下表详细说明了该组件的所有受支持版本、与该组件的版本兼容的 AEM 版本以及指向早期版本文档的链接。
有关电子邮件核心组件版本的更多信息,请参阅文档电子邮件核心组件版本。
本地化网站结构支持 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
。
回退 fallback
电子邮件体验片段组件将尝试按照以下顺序查找对应的本地化组件。
- 首先尝试查找语言根。
- 如果未找到,则尝试查找 Blueprint。
- 如果未找到,则尝试查找实时副本。
- 如果未找到,则它会默认为在组件中配置的体验片段。
技术详细信息 technical-details
阅读最新的有关体验片段组件的技术文档。
在核心组件开发人员文档中可找到有关开发核心组件的其他详细信息。
“配置”对话框 configure-dialog
利用“配置”对话框,内容作者可以选择应在内容上渲染的体验片段变体。
使用 打开选择对话框 按钮可打开组件选择器,来选择要添加到内容页面中的体验片段组件变体。
如果您将电子邮件体验片段组件添加到模板,如果体验片段已本地化,则它会自动本地化,因此根据您明确选择的组件,页面上渲染的内容会变化。 有关更多信息,请参阅以上示例。
您还可以定义 ID。此选项允许控制 HTM 中组件的唯一标识符。
- 如果留空,系统会自动为您生成一个唯一 ID,可以通过检查结果内容找到该 ID。
- 如果指定一个 ID,作者有责任确保它是唯一的。
- 更改 ID 会对 CSS 产生影响。
样式选项卡 styles-tab-edit
电子邮件体验片段组件支持 AEM 样式系统。
使用下拉菜单选择要应用于该组件的样式。在“编辑”对话框中所做的选择与从组件工具栏中选择的操作效果相同。
必须在“设计”对话框中为此组件配置样式,以便选项卡可用。
“设计”对话框 design-dialog
使用“设计”对话框,模板作者可以定义哪些选项可供使用电子邮件体验片段组件的内容作者使用,以及在放置电子邮件体验片段组件时的默认设置。
样式选项卡 styles-tab
电子邮件体验片段组件支持 AEM 样式系统。