體驗片段元件(v1) experience-fragment-component
核心元件體驗片段元件可讓內容作者在支援當地語系化網站結構時,將體驗片段變數放置在頁面上。
使用情況 usage
核心元件體驗片段元件可讓內容作者從現有的體驗片段變數中選取,並將其放置在內容頁面上。 體驗片段元件也支援本地化的網站結構。
版本和相容性 version-and-compatibility
本檔案說明體驗片段元件v1,此版本隨2019年9月的核心元件發行版本2.6.0的發佈引入。
當地語系化網站結構支援 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。
- 如果未找到,則會嘗試尋找即時副本。
- 如果找不到,其預設值為元件中設定的體驗片段。
範例元件輸出 sample-component-output
若要體驗體驗體驗片段元件並檢視其設定選項範例以及HTML和JSON輸出,請造訪元件資料庫。
技術細節 technical-details
您可以在GitHub🔗上找到體驗片段元件的最新技術檔案。
在核心元件開發人員檔案中可找到有關開發核心元件的進一步詳細資料。
設定對話方塊 configure-dialog
此設定對話方塊可讓內容作者選取應在頁面上呈現的體驗片段變數。
使用 開啟選取範圍對話方塊 按鈕開啟元件選擇器,選擇要新增至內容頁面的體驗片段元件變數。
如果您將體驗片段元件新增至範本,請注意,體驗片段一旦本地化,就會自動本地化,因此根據您明確選取的元件,頁面上呈現的內容可能會有所不同。 如需詳細資訊,請參閱以上範例。
您也可以定義 ID。 此選項允許控制HTML和資料層中元件的唯一識別碼。
- 如果保留為空白,系統會自動為您產生唯一ID,並可透過檢查結果頁面找到該ID。
- 若指定ID,作者應負責確認該ID為唯一ID。
- 變更ID會對CSS、JS和資料層追蹤造成影響。
設計對話方塊 design-dialog
「設計」對話方塊可讓範本作者定義哪些選項可供使用體驗片段元件的內容作者使用,以及在放置體驗片段元件時的預設設定。
樣式索引標籤 styles-tab
體驗片段元件支援AEM 樣式系統。