탐색 구성 요소 (v1) navigation-component

사용자는 탐색 구성 요소를 사용하여 전역 사이트 구조를 간편하게 탐색할 수 있습니다.

사용량 usage

사이트 사용자가 사이트 구조를 간편하게 탐색할 수 있도록 탐색 구성 요소는 페이지 트리를 보여 줍니다.

탐색 구성 요소는 전역 사이트 구조를 자동으로 감지하고 현지화된 페이지에 자동으로 적용될 수 있습니다.또한 메인 콘텐츠 구조 이외의 다른 구조를 보여 주기 위해 섀도 리디렉션 페이지를 사용하여 임의의 사이트 구조를 지원할 수 있습니다.

콘텐츠 작성자는 편집 대화 상자를 통해 탐색의 깊이와 함께 탐색 루트 페이지를 정의할 수 있습니다. 템플릿 작성자는 디자인 대화 상자를 통해 탐색 루트 및 깊이에 대한 기본값을 정의할 수 있습니다.

버전 및 호환성 version-and-compatibility

탐색 구성 요소는 2018년 1월 핵심 구성 요소 릴리스 2.0.0과 함께 도입된 v1입니다. 이 문서에서는 해당 구성 요소에 대해 설명합니다.

현지화된 사이트 구조 지원 localized-site-structure

지역에 따라 여러 언어로 웹 사이트가 제공되는 경우가 있습니다. 일반적으로 현지화된 페이지에는 페이지 템플릿의 일부로 포함된 탐색 요소가 포함됩니다. 탐색 구성 요소를 통해 사이트 페이지의 모든 템플릿에 구성 요소가 한 번 배치되면 전역 사이트 구조에 따라 현지화된 개별 페이지에 자동으로 적용됩니다.

예 example-localization

콘텐츠의 형태가 다음과 같습니다.

/content
+-- wknd
   +-- language-masters
      +-- de
         \-- experience
            \-- arctic-surfing-in-lofoten
      +-- en
         \-- experience
            \-- arctic-surfing-in-lofoten
      +-- es
      +-- fr
      \-- it
   +-- us
      +-- en
         \-- experience
            \-- arctic-surfing-in-lofoten
      \-- es
   \-- ch
      +-- de
         \-- experience
            \-- arctic-surfing-in-lofoten
      +-- fr
      \-- it
+-- wknd-events
\-- wknd-shop

사이트 WKND의 경우 탐색 구성 요소를 머리말의 일부로서 페이지 템플릿에 배치할 수도 있습니다. 템플릿의 일부인 경우 구성 요소의 탐색 루트 ​가 해당 사이트 마스터 콘텐츠의 시작점이 되기 때문에 해당 루트를 /content/wknd/language-masters/en로 설정할 수 있습니다. 또한 탐색 구조 깊이 ​를 2로 설정하려는 이유는 전체 콘텐츠 트리가 구성 요소가 아니라 처음 두 레벨에 의해 표시되기 때문입니다.

탐색 루트 값을 사용하여 탐색 구성 요소는 /content/wknd/language-masters/en 이후 탐색과 동시에 사이트 구조가 반복적으로 2단계 하향 조정되면서(탐색 구조 깊이 ​로 정의) 탐색 옵션을 생성할 수 있다고 인식하고 있습니다.

사용자가 조회 중인 페이지가 아무리 현지화되어도 탐색 구성 요소는 현재 페이지 위치를 인지하면서 현지화된 해당 페이지를 찾을 수 있습니다. 루트로 거슬러 올라간 다음 순차적으로 해당 페이지로 내려옵니다.

따라서 방문자가 /content/ch/de/experience/arctic-surfing-in-lofoten를 조회하고 있다면 구성 요소는 /content/wknd/language-masters/de에 따라 탐색 구조를 생성해야 한다는 것을 인지합니다. 마찬가지로 방문자가 /content/us/en/experience/arctic-surfing-in-lofoten를 조회하고 있다면 구성 요소는 /content/wknd/language-masters/en에 따라 탐색 구조를 생성해야 한다는 것을 인지합니다.

새도 사이트 구조 지원 shadow-structure

경우에 따라 실제 사이트 구조와 다른 방문자용 탐색 메뉴를 만들 필요가 있습니다. 프로모션을 통해 콘텐츠 목록이 재정렬되면 메뉴의 특정 콘텐츠가 노출될 수 있습니다. 간단히 다른 콘텐츠 페이지로 리디렉션하는 그림자 페이지를 사용하여 탐색 구성 요소는 임의로 필요한 탐색 사이트 구조를 생성할 수 있습니다.

이렇게 하려면 다음 작업을 수행해야 합니다.

그러면 탐색 구성 요소는 그림자 사이트 구조에 따라 메뉴를 렌더링합니다. 구성 요소에서 렌더링한 링크는 그림자 페이지 자체가 아니라 그림자 페이지가 리디렉션하는 실제 콘텐츠 페이지에 연결됩니다. 또한, 탐색이 그림자 페이지에 따라 달라지는 경우에도 구성 요소에 실제 페이지 이름이 표시되고 활성 페이지가 강조 표시됩니다. 방문자가 탐색 구성 요소를 사용하면 그림자 페이지가 완전히 투명해집니다.

탐색에서 리디렉션 redirects

페이지에 리디렉션 대상이 있으면(외부 URL 또는 다른 AEM 페이지 지정 여부에 관계없이) 탐색 구성 요소에는 리디렉션 대상의 URL을 직접 지정하는 링크가 포함됩니다.

예 redirect-example

샘플 구성 요소 출력 sample-component-output

탐색 구성 요소를 경험하고 구성 옵션의 샘플뿐만 아니라 HTML 및 JSON 출력을 확인하려면 구성 요소 라이브러리를 참조하십시오.

기술 세부 사항 technical-details

탐색 구성 요소에 대한 최신 기술 설명서는 GitHub에서 확인할 수 있습니다.

핵심 구성 요소 개발에 대한 자세한 내용은 핵심 구성 요소 개발자 설명서를 참조하십시오.

편집 대화 상자 edit-dialog

편집 대화 상자에서 콘텐츠 작성자는 탐색을 위한 루트 페이지와 탐색 구조의 깊이를 정의할 수 있습니다.

속성 탭 properties-tab

접근성 탭 accessibility-tab

접근성 탭에서 구성 요소에 대한 ARIA 접근성 라벨 값을 설정할 수 있습니다.

디자인 대화 상자 design-dialog

템플릿 작성자는 디자인 대화 상자를 통해 콘텐츠 작성자에게 제공되는 탐색 루트 페이지와 탐색 깊이에 대한 기본값을 정의할 수 있습니다.

속성 탭 properties-tab-design

스타일 탭 styles-tab

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

Adobe 클라이언트 데이터 레이어 data-layer

탐색 구성 요소는 Adobe 클라이언트 데이터 레이어지원합니다.