電子郵件體驗片段元件 email-experience-fragment-component

Last update: Mon Oct 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
核心組件

建立對象：

開發人員
管理員
使用者

電子郵件體驗片段元件可讓內容作者在其內容中放置體驗片段變化版本，同時支援本地化內容結構。

用途 usage

電子郵件體驗片段元件可讓內容作者從現有的體驗片段變化版本中選取，並將其放置到內容中。體驗片段是同時包含內容和版面的內容群組，並可跨管道重複使用。

該元件的屬性可在設定對話框中定義。
將元件新增至內容時，可在設計對話框中定義預設值。

電子郵件體驗片段元件支援本地化網站結構。

版本和相容性 version-and-compatibility

電子郵件體驗片段元件的目前版本為 v1，此版本於 2022 年 10 月隨著電子郵件核心元件 X 版發行導入，詳情請參閱本文件。

下表詳細說明該元件的所有支援版本、與元件版本相容的 AEM 版本，以及舊版文件的連結。

元件版本

AEM 6.5

AEM 6.5 LTS

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。