語言導覽元件 | Adobe Experience Manager

文件 AEM 核心元件指南

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

相容

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

範例元件輸出 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之後，導覽開始，而且它可以將內容樹狀結構中的下兩個層級辨識為網站的語言導覽結構（如 語言結構深度 值所定義），以產生語言導覽選項。

無論使用者正在檢視哪個頁面，語言導覽元件都可透過知道目前頁面的位置，並回溯至根目錄，然後前進至對應頁面，找到採用另一種語言的對應頁面。