아코디언 구성 요소

핵심 구성 요소 아코디언 구성 요소를 사용하면 페이지에 아코디언 형태로 정렬된 패널 모음을 만들 수 있습니다.

사용량

핵심 구성 요소 아코디언 구성 요소를 사용하면 탭 구성 요소와 마찬가지로 페이지에 아코디언 형태로 구성하고 구성된 구성 요소 모음을 만들 수 있지만 패널을 확장 및 축소할 수 있습니다.

• 아코디언 속성은 구성 대화 상자에서 정의할 수 있습니다.
• 아코디언 패널의 순서는 구성 대화 상자와 선택 패널 팝오버에서 정의할 수 있습니다.
• 페이지에 추가할 때 아코디언 구성 요소의 기본값은 디자인 대화 상자에서 정의할 수 있습니다.

패널에 대한 딥 링크

아코디언 및 탭 구성 요소 지원 기능이 구성 요소 내의 패널에 직접 연결됩니다.

이를 위해 진행되는 작업:

1. 페이지 편집기에서 게시된 것으로 보기 옵션을 사용하여 구성 요소가 있는 페이지를 봅니다.
2. Inspect에서 페이지의 내용을 추가하고 패널의 ID를 식별합니다.
   • 예 id="accordion-86196c94d3-item-ca319dbb0b"
3. ID는 해시(#)를 사용하여 URL에 추가할 수 있는 앵커가 됩니다.
   • 예 https://wknd.site/content/wknd/language-masters/en/magazine/western-australia.html#accordion-86196c94d3-item-ca319dbb0b

패널 ID를 앵커로 사용하여 URL로 이동하면 브라우저가 특정 구성 요소로 직접 스크롤하여 지정된 패널을 표시합니다. 패널이 기본적으로 확장되지 않도록 구성된 경우 자동으로 확장됩니다.

버전 및 호환성

현재 버전의 아코디언 구성 요소는 v1이며, 2019년 6월 핵심 구성 요소 릴리스 2.5.0에 도입되었으며 이 문서에 설명되어 있습니다.

다음 표에서는 구성 요소의 지원되는 모든 버전, 구성 요소 버전이 호환되는 AEM 버전 및 이전 버전에 대한 설명서 링크에 대해 자세히 설명합니다.

구성 요소 버전	AEM 6.4	AEM 6.5	AEM as a Cloud Service
v1	호환 가능	호환 가능	호환 가능

핵심 구성 요소 버전 및 릴리스에 대한 자세한 내용은 핵심 구성 요소 버전 문서를 참조하십시오.

샘플 구성 요소 출력

아코디언 구성 요소를 경험할 수 있을 뿐만 아니라 구성 옵션의 예 및 HTML 및 JSON 출력을 보려면 구성 요소 라이브러리를 방문하십시오.

기술 세부 정보

아코디언 구성 요소 에 대한 최신 기술 문서는 GitHub에서 찾을 수 있습니다.

핵심 구성 요소 개발에 대한 자세한 내용은 핵심 구성 요소 개발자 설명서에서 확인할 수 있습니다.

구성 대화 상자

구성 대화 상자를 사용하면 컨텐츠 작성자가 아코디언 항목, 패널, 방문자가 페이지에 대해 동작하고 표시할 방법을 정의할 수 있습니다.

항목 탭

추가 단추를 사용하여 구성 요소 선택기를 열어 패널로 추가할 구성 요소를 선택합니다. 한 번 추가되면 다음 열이 포함된 항목이 목록에 추가됩니다.

• 아이콘 - 목록에서 쉽게 식별할 수 있도록 패널의 구성 요소 유형의 아이콘입니다. 전체 구성 요소 이름을 툴팁으로 보려면 마우스를 위에 놓으십시오.
• 설명 - 패널의 텍스트로 사용되는 설명으로서, 패널에 대해 선택된 구성 요소의 이름 기본값으로 설정됩니다.
• 삭제 - 아코디언 구성 요소에서 패널을 삭제하려면 탭하거나 클릭합니다.
• 재배치 - 탭하거나 클릭하고 드래그하여 패널 순서를 재정렬합니다.

속성 탭

• 단일 항목 확장 - 이 옵션을 선택하면 단일 아코디언 항목이 한 번에 확장됩니다. 한 항목을 확장하면 다른 항목이 모두 축소됩니다.
• 확장된 항목 - 이 옵션은 페이지를 로드할 때 기본적으로 확장된 항목을 정의합니다.
  • 단일 항목 확장​을 선택한 경우 하나의 패널을 선택해야 합니다. 기본적으로 첫 번째 패널이 선택됩니다.
  • 단일 항목 확장​을 선택하지 않은 경우 이 옵션은 다중 선택이며 선택 사항입니다.
• ID - 이 옵션을 사용하면 HTML 및 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다.
  • 비워 두면 자동으로 고유 ID가 생성되며 결과 페이지를 검사하여 찾을 수 있습니다.
  • ID가 지정된 경우 작성자는 ID가 고유한지 확인해야 합니다.
  • ID를 변경하면 CSS, JS 및 데이터 레이어 추적에 영향을 줄 수 있습니다.

패널 팝업 선택

내용 작성자는 구성 요소 도구 모음에서 패널 선택 옵션을 사용하여 편집할 다른 패널로 변경할 수 있고 아코디언 내의 패널 순서를 쉽게 재정렬할 수 있습니다.

구성 요소 도구 모음에서 패널 선택 옵션을 선택하면 구성된 아코디언 패널이 드롭다운으로 표시됩니다.

• 목록은 패널의 지정된 배열별로 정렬되며 번호 매기기에 반영됩니다.
• 패널의 구성 요소 유형이 먼저 표시되고, 그 다음에 더 밝은 글꼴의 패널 설명이 표시됩니다.
• 드롭다운에서 항목을 탭하거나 클릭하면 편집기의 보기가 해당 패널로 전환됩니다.
• 드래그 핸들을 사용하여 패널을 제자리에 배치할 수 있습니다.

디자인 대화 상자

템플릿 작성자는 디자인 대화 상자를 사용하여 아코디언 구성 요소를 배치할 때 설정된 기본값과 아코디언 구성 요소를 사용하는 컨텐츠 작성자가 사용할 수 있는 옵션을 정의할 수 있습니다.

속성 탭

• 허용되는 머리글 요소 - 이 다중 선택 드롭다운은 작성자가 선택할 수 있는 아코디언 항목 제목 HTML 요소를 정의합니다.
• 기본 머리글 요소 - 이 드롭다운은 기본 아코디언 항목 제목 HTML 요소를 정의합니다.

허용된 구성 요소 탭

허용된 구성 요소 탭은 내용 작성자가 아코디언 구성 요소의 패널에 항목으로 추가할 수 있는 구성 요소를 정의하는 데 사용됩니다.

허용된 구성 요소 탭은 템플릿 편집기에서 레이아웃 컨테이너의 정책 및 속성을 정의할 때 같은 이름의 탭과 동일한 방식으로 작동합니다.

스타일 탭

아코디언 구성 요소는 AEM 스타일 시스템을 지원합니다.