語言導覽元件(v1) | Adobe Experience Manager

文件 AEM 核心元件指南

Last update: Fri May 26 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Core Components

建立對象：

Developer
Admin
User

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

使用狀況 usage

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

如需語言導覽元件本地化功能運作方式的範例，請參閱下節.
如需其他核心元件本地化功能如何搭配運作的範例，請參閱核心元件頁面的本地化功能.

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

版本和相容性 version-and-compatibility

本檔案說明語言導覽元件v1，此元件隨2018年1月的核心元件發行版本2.0.0的發佈引入。

CAUTION

本檔案說明語言導覽元件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 會識別內容樹狀結構中的下兩個層級為網站的語言導覽結構(如 語言結構深度 值)。

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