컨텐츠 조각 목록 구성 요소

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

사용량

핵심 구성 요소 컨텐츠 조각 목록 구성 요소를 사용하면 컨텐츠 조각 모델을 기반으로 페이지에 컨텐츠 조각 목록을 포함할 수 있습니다. 다른 응용 프로그램에서 쉽게 사용할 수 있는 헤드리스 내용을 만드는 데 특히 유용합니다.

버전 및 호환성

컨텐츠 조각 구성 요소의 현재 버전은 v1이며, 2019년 5월 핵심 구성 요소 릴리스 2.4.0에서 도입되었으며 이 문서에 설명되어 있습니다.

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

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

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

샘플 구성 요소 출력

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

기술 세부 정보

컨텐츠 조각 목록 구성 요소 에 대한 최신 기술 문서는 GitHub에서 찾을 수 있습니다.

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

구성 대화 상자

구성 대화 상자를 사용하면 컨텐츠 작성자가 목록에 포함할 컨텐츠 조각과 해당 조각 요소를 정의할 수 있습니다.

속성 탭

속성 탭은 목록에 포함되어 있는 컨텐츠 조각을 정의합니다. 기본적으로 선택된 컨텐츠 조각 모델을 기반으로 하지만 사용할 수 있는 다른 필터 옵션이 있습니다.

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

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

주문 기준, 정렬 순서최대 항목 수 옵션이 핵심 구성 요소 릴리스 2.7.0과 함께 도입되었습니다.

요소 탭

기본적으로 컨텐츠 조각 모델의 모든 요소는 목록에 포함됩니다(단, 최대 항목 필드에 의해 제한되지 않음). Elements 탭에서는 포함할 특정 요소만 지정할 수 있습니다.

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

  • 요소 - 지정된 목록의 컨텐츠 조각 요소만 표시됩니다.
    • 추가 단추를 클릭하거나 탭하여 새 요소를 추가합니다.
    • 삭제 단추를 클릭하거나 탭하여 선택한 요소를 제거합니다.
    • 주문 핸들을 드래그하여 요소의 순서를 다시 정렬합니다.

디자인 대화 상자

템플릿 작성자는 디자인 대화 상자를 사용하여 컨텐츠 조각 목록 구성 요소에 적용된 스타일을 정의할 수 있습니다.

이 페이지에서는