體驗片段元件 experience-fragment-component

Last update: Mon Jul 15 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。