語言導覽元件 language-navigation-component

語言導覽元件提供網站的語言/國家導覽,讓訪客可以導覽至不同地區設定的相同頁面。

使用狀況 usage

網站通常以多種語言提供給不同地區。 語言導覽元件可讓訪客以不同語言/地區設定檢視相同頁面。 因此,如果您是網站的瑞士德文版的讀者,可以輕鬆切換至相同頁面的美式英文版。 語言導覽元件可讓您瞭解網站語言結構,並自動找到對應的頁面。

編輯對話方塊 可定義全域網站導覽根目錄,以及導覽在結構中的深度。 使用 設計對話方塊,範本作者可以設定相同選項的預設值。

版本和相容性 version-and-compatibility

語言導覽元件的目前版本是v2,此版本隨2022年2月的核心元件2.18.0版的發佈引入,具體說明見本文。

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

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

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

範例元件輸出 sample-component-output

若要體驗語言導覽元件並檢視其設定選項範例以及HTML和JSON輸出,請造訪 元件資料庫.

技術細節 technical-details

有關語言導覽元件的最新技術檔案 可在GitHub上找到.

有關開發核心元件的進一步詳細資訊,請參閱 核心元件開發人員檔案.

設計對話方塊 design-dialog

「設計」對話方塊可讓您定義全域網站導覽根目錄,以及導覽在結構中應該深入到什麼程度。

這些設定通常只需在頁面範本層級完成。 不過,您可在頁面層級透過 編輯對話方塊.

屬性標籤 properties-tab

語言導覽元件的設計對話方塊

  • 導覽根目錄

    • 這是網站語言導覽的開始位置。
    • 網站的語言結構會從此根目錄下的下一個層級開始。
  • 語言結構深度

    • 這是目錄下的內容樹狀結構層級 導覽根目錄 代表網站的語言結構。 範例:

      • 1 通常表示您只能選擇語言。
      • 2 通常表示您可以選擇語言和國家/地區。
      • 3 通常表示您可以選擇語言、國家/地區和區域。

範例 example

假設您的內容看起來像這樣:

/content
+-- wknd
   +-- language-masters
   +-- us
      +-- en
      \-- es
   \-- ch
      +-- de
      +-- fr
      \-- it
+-- wknd-events
\-- wknd-shop

對於網站WKND,您可能想要將語言導覽元件放在頁面範本上作為標頭的一部分。 一旦成為範本的一部分,您就可以將 導覽根目錄 的元件至 /content/wknd 因為這是您網站本地化內容的開始位置。 您也會想要設定 語言結構深度 成為 2 因為您的結構有兩個層級(國家/地區然後語言)。

使用 導覽根目錄 值,則語言元件會在以下步驟後得知該 /content/wknd 會識別內容樹狀結構中的下兩個層級為網站的語言導覽結構(如 語言結構深度 值)。

無論使用者正在檢視哪個頁面,語言導覽元件都可藉由知道目前頁面的位置,並向後移至根目錄,然後向前移至對應頁面,找到其他語言的對應頁面。

樣式索引標籤 styles-tab

語言導覽元件支援AEM 樣式系統.

編輯對話方塊 edit-dialog

屬性標籤 properties-tab-edit

通常,只需在網站的頁面範本中新增及設定語言導覽元件。 不過,如果需要將「語言導覽」元件新增至個別內容頁面,內容作者就可以利用「編輯」對話方塊來設定相同的值,如 設計對話方塊

此外,您可以設定 ID. 此選項可讓您控制HTML和中的元件的唯一識別碼 資料層.

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

語言導覽元件的編輯對話方塊

協助工具標籤 accessibility-tab

  • 標籤 — 如果頁面上有多個語言導覽來設定元件的aria標籤屬性,則應定義此選項。

語言導覽協助工具索引標籤

樣式索引標籤 styles-tab-edit

語言導覽元件支援AEM 樣式系統。.

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

必須在以下位置為此元件設定樣式: 設計對話方塊 讓下拉式功能表可供使用。

語言導覽元件「編輯」對話方塊的「樣式」索引標籤

Adobe使用者端資料層 data-layer

語言導覽元件支援 Adobe使用者端資料層。

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