Show Menu
TOPICS×

Language Navigation Component

언어 탐색 구성 요소는 방문자가 다른 로케일에서 동일한 페이지로 이동할 수 있도록 사이트에 대한 언어/국가 탐색을 제공합니다.

사용량

웹 사이트는 서로 다른 지역에 대해 여러 언어로 제공되는 경우가 많습니다. 언어 탐색 구성 요소를 사용하면 방문자가 동일한 페이지를 다른 언어/로케일로 볼 수 있습니다. 스위스 독일어 버전의 웹 사이트에서 독자를 사용하고 있는 경우 동일한 페이지의 미국 영어 버전으로 쉽게 전환할 수 있습니다. 언어 탐색 구성 요소는 사이트 언어 구조를 파악하고 해당 페이지를 자동으로 찾습니다.
[편집] 대화 상자를 사용하면 전역 사이트 탐색 루트의 정의뿐만 아니라 탐색이 가야 하는 구조의 깊이를 확인할 수 있습니다. 템플릿 작성자는 디자인 대화 상자를 사용하여 동일한 옵션에 대한 기본값을 설정할 수 있습니다.

버전 및 호환성

언어 탐색 구성 요소의 현재 버전은 v1이며, 2018년 1월에 핵심 구성 요소 릴리스 2.0.0에서 도입되었으며 이 문서에 설명되어 있습니다.
다음 표에서는 구성 요소의 지원되는 모든 버전, 구성 요소의 버전이 호환되는 AEM 버전 및 이전 버전에 대한 설명서 링크에 대해 자세히 설명합니다.
구성 요소 버전
AEM 6.4
AEM 6.5
클라우드 서비스로서의 AEM
v1
호환 가능
호환 가능
호환 가능
핵심 구성 요소 버전 및 릴리스에 대한 자세한 내용은 핵심 구성 요소 버전을 참조하십시오 .

샘플 구성 요소 출력

HTML 및 JSON 출력뿐만 아니라 언어 탐색 구성 요소의 구성 옵션 예를 보려면 구성 요소 라이브러리를 방문하십시오 .

기술 세부 정보

언어 탐색 구성 요소에 대한 최신 기술 문서는 GitHub에서 찾을 수 있습니다 .
핵심 구성 요소 개발에 대한 자세한 내용은 핵심 구성 요소 개발자 설명서를 참조하십시오 .

디자인 대화 상자

편집 대화 상자에서는 전역 사이트 탐색 루트의 정의뿐만 아니라 탐색이 가야 하는 구조의 깊이를 확인할 수 있습니다.
일반적으로 이러한 구성은 페이지 템플릿 수준에서만 수행해야 합니다. 하지만 페이지 수준에서 편집 대화 상자를 통해 변경할 수 있습니다 .

속성 탭

  • 탐색 루트
    • 이 위치에서 사이트의 언어 탐색을 시작해야 합니다.
    • 사이트의 언어 구조는 이 루트 아래의 다음 수준에서 시작됩니다.
  • 언어 구조 깊이
    • 탐색 루트 아래의 콘텐츠 트리 수준
      수는 사이트의 언어 구조를 나타냅니다. 예:
      • 1
        일반적으로 언어 선택만 있다는 것을 의미합니다.
      • 2
        일반적으로 언어와 국가를 선택할 수 있음을 의미합니다.
      • 3
        일반적으로 언어, 국가 및 지역을 선택할 수 있습니다.

귀하의 컨텐츠가 다음과 같이 보인다고 가정하겠습니다.
/content +-- wknd +-- language-masters +-- us +-- en \-- es \-- ch +-- de +-- fr \-- it +-- wknd-events \-- wknd-shop
사이트 WKND의 경우 페이지 템플릿에 언어 탐색 구성 요소를 머리글의 일부로 배치하려고 할 수 있습니다. 템플릿의 일부로 구성 요소의
탐색 루트가
해당 사이트에 대한 현지화된 컨텐츠가 시작되는 곳이기
/content/wknd
때문에 구성 요소의 탐색 루트를 설정할 수 있습니다. 구조가 두 수준(국가 및 언어)이므로
언어 구조
깊이를
2
설정할 수도 있습니다.
# 값을 사용하면 언어 구성 요소는 탐색
/content/wknd
이 시작된 후, 언어 구성 요소는 컨텐츠 트리의 다음 두 수준을 사이트의 언어 탐색 구조(
언어 구조 깊이
값으로 정의됨)로 인식하여 언어 탐색 옵션을 생성할 수 있음을알고 있습니다.
사용자가 보고 있는 페이지에 관계없이 언어 탐색 구성 요소는 현재 페이지의 위치를 알고 루트로 거꾸로 작업한 다음 해당 페이지로 이동하여 다른 언어로 해당 페이지를 찾을 수 있습니다.

스타일 탭

언어 탐색 구성 요소는 AEM 스타일 시스템을 지원합니다 .

Edit Dialog

일반적으로 언어 탐색 구성 요소는 사이트의 페이지 템플릿에만 추가하고 구성해야 합니다. 그러나 개별 컨텐츠 페이지에 언어 탐색 구성 요소를 추가해야 하는 경우 편집 대화 상자를 사용하면 컨텐츠 작성자가 디자인 대화 상자에 설명된 것과 동일한 값을 구성할 수 있습니다 .
또한
ID를 설정할 수도 있습니다
. 이 옵션을 사용하면 HTML 및 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다 .
  • 비워 두면 자동으로 고유 ID가 생성되어 결과 페이지를 검사하여 찾을 수 있습니다.
  • ID가 지정된 경우 작성자는 ID가 고유한지 확인해야 합니다.
  • ID를 변경하면 CSS, JS 및 데이터 레이어 추적에 영향을 줄 수 있습니다.