階層連結元件 breadcrumb-component

核心元件階層連結元件是一種導覽元件,可根據頁面在內容階層中的位置建立連結的階層連結。

使用情況 usage

階層連結元件會顯示目前頁面在網站階層中的位置,讓頁面訪客可以從其目前位置導覽頁面階層。 這通常會整合到頁首或頁尾中。

可用選項(例如預設導覽層級以及顯示目前頁面或隱藏頁面的能力)可由範本作者在設計對話方塊中定義。 然後,內容編輯器就可以在編輯對話方塊中選擇是否應該顯示隱藏的頁面,以及元件的實際導覽層級。

版本和相容性 version-and-compatibility

階層連結元件的目前版本是v3,此版本隨2022年2月的核心元件發行版本2.18.0的發佈引入,詳情請參閱本檔案。

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

元件版本
AEM 6.4
AEM 6.5
AEM as a Cloud Service
v3
-
相容
相容
v2
相容
相容
相容
v1
相容
相容
相容

如需核心元件版本的詳細資訊,請參閱檔案核心元件版本

範例元件輸出 sample-component-output

若要體驗階層連結元件並檢視其設定選項範例以及HTML和JSON輸出,請造訪元件資料庫

NOTE
截至核心元件發行版本2.1.0,階層連結元件支援schema.org微資料

技術細節 technical-details

在GitHub🔗上可找到有關階層連結元件的最新技術檔案。

核心元件開發人員檔案中可找到有關開發核心元件的進一步詳細資料。

編輯對話方塊 edit-dialog

編輯對話方塊可讓內容作者在階層連結中隱藏隱藏和作用中的頁面,以及它應顯示的階層深度。

屬性標籤 properties-tab

階層連結元件編輯對話方塊

  • 導覽開始層級 — 階層中位置的階層連結元件應該開始向下走到目前頁面。 例如:

    • 0從/content開始
    • 1在/content/<yourSite>開始
    • 2在/content/<yourSite>/<country>開始
  • 顯示隱藏的導覽專案 — 在階層連結中顯示標籤為隱藏的頁面(預設不會顯示這些頁面)

  • 隱藏目前頁面 — 在階層連結中隱藏目前頁面(預設會顯示)

  • 停用陰影 — 如果階層中的頁面是重新導向,將顯示重新導向頁面的名稱而非目標。 如需詳細資訊,請參閱導覽元件的陰影網站結構支援

  • ID — 此選項可控制HTML和資料層中元件的唯一識別碼。

    • 如果保留為空白,系統會自動為您產生唯一ID,並可透過檢查結果頁面找到該ID。
    • 若指定ID,作者應負責確認該ID為唯一ID。
    • 變更ID會對CSS、JS和資料層追蹤造成影響。

樣式索引標籤 styles-tab-edit

階層連結清單元件之編輯對話方塊的 樣式索引標籤

階層連結元件支援AEM 樣式系統。

使用下拉式清單,選取要套用至元件的樣式。 在「編輯」對話方塊中所做的選取與從元件工具列中選擇的選取具有相同的效果。

必須在設計對話方塊中為此元件設定樣式,以便下拉式功能表可用。

設計對話方塊 design-dialog

「設計」對話方塊可讓範本作者定義選項的預設值,以隱藏階層連結中的隱藏與作用中頁面,以及應顯示的階層深度。

主要標籤 main-tab

  • 導覽開始層級 — 定義階層中位置的預設值,當階層連結元件新增至頁面時,階層連結元件應該從該位置開始向下逐步瀏覽至目前的頁面。

  • 顯示隱藏的導覽專案 — 當階層連結元件新增至頁面時,定義​ 顯示隱藏的導覽專案 ​選項的預設值。

    • 它不會為作者啟用或停用選項。 它只會設定預設值。
  • 隱藏目前頁面 — 當階層連結元件新增至頁面時,定義​ 隱藏目前頁面 ​選項的預設值。

    • 它不會為作者啟用或停用選項。 它只會設定預設值。
  • 停用陰影 — 當階層連結元件新增至頁面時,定義​ 停用陰影 ​選項的預設值。

樣式索引標籤 styles-tab

階層連結元件支援AEM 樣式系統

Adobe使用者端資料層 data-layer

階層連結元件支援Adobe使用者端資料層。

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c