아코디언 구성 요소

마지막 업데이트: 2024년 7월 13일

작성 대상:

핵심 구성 요소의 아코디언 구성 요소를 통해 페이지에서 아코디언으로 배열되는 패널 컬렉션을 만들 수 있습니다.

사용량

핵심 구성 요소의 아코디언 구성 요소를 통해 패널로 구성되고 페이지에서 아코디언으로 배열되는 구성 요소 컬렉션을 만들 수 있습니다. 이는 탭 구성 요소와 유사하지만 패널을 확장 및 축소할 수 있습니다.

현재 버전의 아코디언 구성 요소는 2019년 6월 핵심 구성 요소 릴리스 2.5.0과 함께 도입된 v1입니다. 이 문서에서는 해당 구성 요소에 대해 설명합니다.

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

구성 요소 버전	AEM 6.4	AEM 6.5	AEM as a Cloud Service
v1	릴리스 2.17.4 및 이전 버전과 호환 가능	호환 가능	호환 가능

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

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

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

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

아코디언, 캐러셀 및 탭 구성 요소는 구성 요소 내에서 패널로 직접 링크하는 기능을 지원합니다.

이를 위해 진행되는 작업:

페이지 편집기의 게시로 보기 옵션을 사용하여 구성 요소와 함께 페이지를 조회합니다.
페이지 콘텐츠를 검사하고 패널의 ID를 식별합니다.
- 예 id="accordion-86196c94d3-item-ca319dbb0b"
ID는 해시로 URL에 추가될 수 있는 앵커가 됩니다(#).
- 예 https://wknd.site/content/wknd/language-masters/en/magazine/western-australia.html#accordion-86196c94d3-item-ca319dbb0b

패널 ID를 앵커로 사용하여 URL로 이동하면 브라우저는 특정 구성 요소로 바로 스크롤하고 지정 패널을 표시합니다. 패널 확장이 기본 구성되어 있지 않으면 패널은 자동으로 확장됩니다.

모든 핵심 구성 요소는 완벽하게 반응하도록 설계되어 여러 장치에서 원활한 경험을 보장합니다.

아코디언 구성 요소와 같은 일부 고급 구성 요소는 모든 상태에서 응답성을 유지하기 위해 구현 프로젝트의 맥락 내에서 특별한 고려 사항이 필요할 수 있습니다. 자세한 내용은 핵심 구성 요소의 반응형 디자인 문서를 참조하십시오.

콘텐츠 작성자는 구성 대화 상자를 통해 아코디언 항목, 패널과 방문자를 위한 페이지 작동 및 표시 방법을 정의할 수 있습니다.

아코디언 구성 요소의 편집 대화 상자 항목 탭

추가 버튼을 사용하여 패널로 추가할 구성 요소를 선택하는 구성 요소 선택기를 엽니다. 추가되면 다음 열이 포함된 목록에 항목을 추가합니다.

TIP

페이지 뷰포트가 작아져 편집 대화 상자가 전체 화면이 되면 추가 버튼이 표시되지 않습니다. 구성 요소 브라우저를 드래그하여 페이지 편집기의 아코디언 구성 요소에 드롭하여 구성 요소를 아코디언 구성 요소에 추가할 수 있습니다.

아코디언 구성 요소의 편집 대화 상자 속성 탭

단일 항목 확장 - 선택되면 이 옵션은 한 번에 단일 아코디언 항목을 강제 확장시킵니다. 한 개의 항목이 확장되면 다른 모든 항목은 축소됩니다.
확장된 항목 -페이지가 로드되면 이 옵션은 기본적으로 확장된 항목을 정의합니다.
- 단일 항목 확장 이 선택되면 한 개의 패널을 선택해야 합니다. 기본적으로 첫 번째 패널을 선택합니다.
- 단일 항목 확장 이 선택되지 않으면 이 옵션을 다중 선택합니다(선택 사항).
ID - 이 옵션을 통해 HTML과 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다.
- 비워 두면 고유 ID는 자동으로 생성되고 결과 페이지 검사를 통해 발견될 수 있습니다.
- ID가 지정된 경우 작성자는 ID가 고유한지 확인해야 합니다.
- ID가 변경되면 CSS, JS 및 데이터 레이어 추적에 영향을 미칠 수 있습니다.