體驗片段元件 experience-fragment-component

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

主題：
核心組件

建立對象：

開發人員
管理員
使用者

透過核心元件體驗片段元件，內容作者可於頁面上放置體驗片段變化版本，同時支援本地化網站架構。

TIP

您是否考慮過適用於 AEM 的 Edge Delivery Services？

現有的專案可以繼續使用本文件中所述的方法。然而，針對新專案，Adobe 建議採用 Edge Delivery Services。

用途 usage

透過核心元件體驗片段元件，內容作者可從現有的體驗片段變化版本中選取，並將其放置在內容頁面上。體驗片段元件同樣支援本地化網站結構。

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

版本和相容性 version-and-compatibility

體驗片段元件的目前版本為 v2，此版本於 2022 年 2 月隨著核心元件 2.18.0 版發行導入，詳情請參閱本文件。

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

元件版本

AEM 6.4

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。