목록 구성 요소(v1)

코어 구성 요소 목록 구성 요소를 사용하면 정적 목록뿐만 아니라 동적 목록을 쉽게 만들 수 있습니다.

사용량

목록 구성 요소를 사용하여 하위 페이지의 동적 목록이나 임의로 정의된 항목의 정적 목록 등을 만들 수 있습니다.

사용 가능한 목록 유형 및 서식 옵션은 디자인 대화 상자에서 템플릿 작성자가 정의할 수 있습니다. 콘텐츠 편집기는 사용 가능한 목록 유형 중에서 선택하고 편집 대화 상자에서 목록 요소의 형식을 지정하는 방법을 선택할 수 있습니다.

버전 및 호환성

이 문서에서는 원래 AEM 6.3과 함께 코어 구성 요소 릴리스 1.0.0에 소개된 목록 구성 요소 v1에 대해 설명합니다.

다음 표에는 목록 구성 요소 v1의 호환성이 나와 있습니다.

AEM 버전 목록 구성 요소 v1
6.3 호환 가능
6.4 호환 가능
주의

이 문서에서는 목록 구성 요소의 v1에 대해 설명합니다.

목록 구성 요소의 현재 버전에 대한 자세한 내용은 목록 구성 요소 문서를 참조하십시오.

샘플 구성 요소 출력

다음은 We.Retail에서 가져온 샘플입니다.

스크린샷

HTML

<div class="cmp cmp-list aem-GridColumn aem-GridColumn--default--12">

<ul>
    <li>
    <article>
        <a href="/content/we-retail/us/en/experience/arctic-surfing-in-lofoten.html">
            <span class="cmp-list--item-title">Arctic Surfing In Lofoten</span>
            
        </a>
        
    </article>
</li>

    <li>
    <article>
        <a href="/content/we-retail/us/en/experience/summit-success-in-the-himalayas.html">
            <span class="cmp-list--item-title">Summit Success in the Himalayas</span>
            
        </a>
        
    </article>
</li>

    <li>
    <article>
        <a href="/content/we-retail/us/en/experience/climbing-on-kalymnos-island--greece.html">
            <span class="cmp-list--item-title">Climbing on Kalymnos Island, Greece</span>
            
        </a>
        
    </article>
</li>

    <li>
    <article>
        <a href="/content/we-retail/us/en/experience/running-at-the-great-wall-marathon.html">
            <span class="cmp-list--item-title">Running at the Great Wall Marathon</span>
            
        </a>
        
    </article>
</li>

    <li>
    <article>
        <a href="/content/we-retail/us/en/experience/skiing-deep-powder-in-siberia.html">
            <span class="cmp-list--item-title">Skiing deep powder in Siberia</span>
            
        </a>
        
    </article>
</li>

    <li>
    <article>
        <a href="/content/we-retail/us/en/experience/climbing-in-the-massif-du-mont-blanc.html">
            <span class="cmp-list--item-title">Climbing in the Massif du Mont Blanc</span>
            
        </a>
        
    </article>
</li>
</ul>

</div>

JSON

"articles_list": {
              "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
              ":type": "weretail/components/content/articleslist",
              "tagsMatch": "any",
              "displayAs": "teaser",
              "feedEnabled": "true",
              "listFrom": "children",
              "limit": "0",
              "orderBy": "cq:lastModified",
              "pageMax": "0"
            }
노트

코어 구성 요소에서 JSON 내보내기를 사용하려면 핵심 구성 요소 릴리스 1.1.0이 필요합니다. 자세한 내용은 코어 구성 요소 v1🔗에 대한 호환성 정보를 참조하십시오.

편집 대화 상자

편집 대화 상자에서는 컨텐츠 작성자가 목록 및 목록 요소를 구성할 수 있습니다.

목록 설정

목록은 다양한 방법으로 작성할 수 있습니다.

목록이 빌드되는 방식에 관계없이 항상 구성할 수 있는 정렬 옵션이 있습니다.

컨텐츠 작성자가 목록을 작성하는 방법에 따라 추가 구성 옵션이 변경됩니다.

하위 페이지

현재 페이지나 다른 페이지의 하위 페이지로 목록을 작성할 수 있습니다.

  • 상위 페이지
    • 하위 페이지가 목록을 만들 페이지입니다
    • 현재 페이지를 사용하려면 비워 둡니다
  • 하위 깊이 - 계층 구조에서 하위 수준 몇 개를 사용해야 합니까?

고정 목록

고정 항목 목록을 사용하여 목록을 작성할 수 있습니다.

추가 단추를 탭하거나 클릭하여 목록에 새 항목을 삽입합니다.

  • 목록에 있는 항목의 텍스트를 입력하거나 선택 대화 상자​를 사용하여 AEM에서 항목을 선택합니다.
  • 드래그 핸들을 사용하여 목록의 항목을 다시 정렬합니다.
  • 목록에서 항목을 삭제하려면 휴지통 아이콘을 사용하십시오.

검색

AEM 컨텐츠 검색 결과를 사용하여 목록을 작성할 수 있습니다.

  • 검색 쿼리 - 목록 요소를 생성하기 위해 전체 텍스트 검색을 실행할 문자열입니다
  • ​에서 검색 - 검색을 실행해야 하는 위치
    • 선택 대화 상자​를 사용하여 AEM에서 위치를 선택합니다
    • 비워 두면 현재 페이지를 사용합니다

태그

특정 위치 아래의 특정 태그와 일치하는 페이지를 사용하여 목록을 작성할 수 있습니다.

  • 상위 페이지 - 태그 일치를 시작해야 하는 위치
    • 선택 대화 상자​를 사용하여 AEM에서 위치를 선택합니다
    • 비워 두면 현재 페이지를 사용합니다
  • 태그 - 일치해야 하는 태그
    • 찾아보기 대화 상자를 사용하여 태그를 선택합니다
  • 일치 - 목록에 포함할 페이지를 분류해야 하는 일치 유형을 정의합니다
    • 임의의 태그
    • 모든 태그

정렬 옵션

목록 작성 방법에 관계없이 항상 정의할 수 있는 특정 정렬 옵션이 있습니다.

  • 정렬 기준 - 요소를 정렬하는 방법
    • 제목
    • 마지막으로 수정한 날짜
  • 정렬 순서 - 품목을 주문해야 하는 순서입니다
    • 오름차순
    • 내림차순
  • 최대 항목 - 목록에 표시되는 최대 항목 수입니다.
    • 모든 항목을 반환하려면 비워 둡니다.

항목 설정

항목 설정 탭을 사용하여 목록 요소의 서식을 구성할 수 있습니다.

  • 항목
    을 해당 페이지에 연결
  • 설명
    표시링크 항목에 대한 설명을 표시합니다
  • 날짜
    표시링크 항목의 수정 날짜 표시

디자인 대화 상자

디자인 대화 상자에서는 템플릿 작성자가 사용 가능한 항목 설정과 컨텐츠 작성자에게 허용해야 하는 목록 유형을 정의할 수 있습니다.

목록 설정

목록 설정 탭에서 날짜 형식을 정의할 수 있으며 컨텐츠 작성자가 구성 요소에서 사용할 수 있는 목록 유형을 정의할 수 있습니다.

  • 날짜 형식 - 마지막 수정 날짜 표시에 사용할 형식
  • 하위 비활성화 - 구성 요소에서 하위 목록 유형을 비활성화합니다
  • 정적 비활성화 - 구성 요소에서 정적 목록 유형을 비활성화합니다
  • 검색 비활성화 - 구성 요소에서 검색 목록 유형을 비활성화합니다
  • 태그 비활성화 - 구성 요소에서 태그 목록 유형 비활성화

항목 설정

항목 설정 탭에서 컨텐츠 작성자의 구성 요소에서 사용할 수 있어야 하는 개별 목록 요소의 서식 옵션을 정의할 수 있습니다.

기술 세부 정보

목록 구성 요소 에 대한 최신 기술 설명서는 GitHub에 있습니다.

전체 코어 구성 요소 프로젝트는 GitHub에서 다운로드할 수 있습니다.

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

이 페이지에서는