콘텐츠 조각 목록 구성 요소

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

주제:
핵심 구성 요소

작성 대상:

개발자
관리자
사용자

핵심 구성 요소의 콘텐츠 조각 목록 구성 요소를 사용하여 콘텐츠 조각 목록을 표시할 수 있습니다.

사용량

핵심 구성 요소의 콘텐츠 조각 목록 구성 요소를 사용하여 콘텐츠 조각 모델에 따라 페이지에 콘텐츠 조각 목록을 포함할 수 있습니다. 다른 애플리케이션에서 간단히 사용할 수 있는 헤드리스 콘텐츠를 제작하는 경우 특히 유용합니다.

구성 대화 상자에서 목록과 목록의 속성을 선택할 수 있습니다.
디자인 대화 상자에서 스타일을 구성 요소에 적용할 수 있습니다.

버전 및 호환성

현재 버전의 콘텐츠 조각 구성 요소는 2022년 2월 핵심 구성 요소 릴리스 2.18.0과 함께 도입된 v2입니다. 이 문서에서는 해당 구성 요소에 대해 설명합니다.

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

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

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

샘플 구성 요소 출력

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

기술 세부 사항

콘텐츠 조각 목록 구성 요소에 대한 최신 기술 설명서는 GitHub에서 확인할 수 있습니다.

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

구성 대화 상자

콘텐츠 작성자는 구성 대화 상자를 통해 포함될 목록과 해당 조각의 요소를 구성하는 콘텐츠 조각을 정의할 수 있습니다.

속성 탭

속성 탭은 목록에 포함된 콘텐츠 조각을 정의합니다. 주로 선택한 콘텐츠 조각 모델을 기반으로 하지만 다른 필터 옵션을 선택할 수 있습니다.

콘텐츠 조각 목록 구성 요소의 편집 대화 상자 속성 탭

모델 - 목록의 기반이 되는 콘텐츠 조각 모델의 경로.
- 기본적으로 모델 경로 로 정의된 모델의 모든 콘텐츠 조각이 목록에 포함됩니다.
상위 경로 - 목록을 빌드해야 하는 상위 경로
- 선택한 모델 경로 를 기반으로 콘텐츠 조각을 지정된 상위 경로 의 조각으로 필터링할 수 있습니다.
  - 필드의 오른쪽 선택 열기 대화 상자 버튼을 클릭하거나 탭하여 경로를 지정합니다.
태그 - 지정된 태그가 있는 콘텐츠 조각만 표시됩니다.
- 필드의 오른쪽 선택 열기 대화 상자 버튼을 클릭하거나 탭하여 태그를 지정합니다.
- 선택한 태그 옆의 x를 클릭하거나 탭하여 태그를 제거합니다.
항목별 순서 - 목록의 순서를 정하는 콘텐츠 조각 모델의 필드
- 텍스트 필드(숫자, 날짜 및 시간)만 선택할 수 있습니다.
정렬 순서 - 항목별 순서 로 목록을 정렬하는 방법
- 오름차순 또는 내림차순
최대 항목 - 목록에 표시될 최대 항목 수
- 값은 모든 항목을 반환하지 않습니다.
ID - 이 옵션을 통해 HTML과 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다.
- 비워 두면 고유 ID는 자동으로 생성되고 결과 페이지 검사를 통해 발견될 수 있습니다.
- ID가 지정된 경우 작성자는 ID가 고유한지 확인해야 합니다.
- ID가 변경되면 CSS, JS 및 데이터 레이어 추적에 영향을 미칠 수 있습니다.