核心元件體驗片段元件允許內容作者在支援本地化站點結構的同時將體驗片段變體放置在頁面上。
核心元件體驗片段元件允許內容作者從現有體驗片段變體中進行選擇,並將其放在內容頁面上。 「體驗片段」元件還支援本地化的站點結構。
經驗片段元件的當前版本是v2,該版本於2022年2月隨核心元件2.18.0版一起推出,本文檔對此進行了說明。
下表詳細說明了元件的所有受支援版本、AEM元件版本與之相容的版本,以及指向早期版本文檔的連結。
元件版本 | AEM 6.4 | AEM 6.5 | AEM as a Cloud Service |
---|---|---|---|
v2 | - | 相容 | 相容 |
v1 | 相容 | 相容 | 相容 |
有關核心元件版本和版本的詳細資訊,請參閱文檔 核心元件版本。
經驗片段元件適用於局部化的站點結構,並基於頁面的本地化來呈現適當的經驗片段。 為此,經驗片段必須滿足以下條件。
/content/<site>
。/content/experience-fragments
遵循與下面的站點相同的模式 /content/<site>
包括使用相同的元件名稱。在這種情況下,與當前頁面具有相同本地化(語言、藍圖或即時副本)的片段將作為模板的一部分呈現。
此行為僅限於添加到模板的「體驗片段元件」。 添加到單個內容頁面的體驗片段元件將呈現元件中配置的確切體驗片段呈現形式。
假設您的內容類似以下內容:
/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
。
體驗片段元件將嘗試按以下順序查找相應的本地化元件。
要體驗Experience Fragment元件,並查看其配置選項以及HTML和JSON輸出的示例,請訪問 元件庫。
有關體驗片段元件的最新技術文檔 可在GitHub上找到。
有關開發核心元件的詳細資訊,請參閱 核心元件開發人員文檔。
通過「配置」對話框,內容作者可以選擇應在頁面上呈現的體驗片段變體。
使用 開啟選擇對話框 按鈕以開啟元件選擇器,以選擇要添加到內容頁面的體驗片段元件變體。
如果將「體驗片段」元件添加到模板,請注意,如果「體驗片段」已本地化,則它將自動本地化,因此在頁面上呈現的內容可能與您明確選擇的元件不同。 請參閱上面的示例 的子菜單。
也可以定義 ID。 此選項允許控制HTML和 資料層。
體驗片段元件支AEM持 樣式系統。。
使用下拉框選擇要應用於元件的樣式。 在編輯對話框中所做的選擇與從元件工具欄中選擇的選項具有相同的效果。
必須在 設計對話框 以便下拉菜單可用。
設計對話框允許模板作者定義內容作者可用的選項,內容作者使用「體驗片段元件」以及放置「體驗片段元件」時設定的預設值。
體驗片段元件支AEM持 樣式系統。