경험 조각 구성 요소

코어 구성 요소 경험 조각 구성 요소를 사용하면 컨텐츠 작성자가 현지화된 사이트 구조를 지원하는 동안 페이지에 경험 조각 변형을 배치할 수 있습니다.

사용량

핵심 구성 요소 경험 조각 구성 요소를 사용하면 컨텐츠 작성자가 기존 경험 조각 변형에서 선택하고 컨텐츠 페이지에 배치할 수 있습니다. 경험 조각 구성 요소는 현지화된 사이트 구조도 지원합니다.

  • 구성 요소의 속성은 구성 대화 상자에서 정의할 수 있습니다.
  • 페이지에 구성 요소를 추가할 때 구성 요소의 기본값은 디자인 대화 상자에서 정의할 수 있습니다.

현지화된 사이트 구조 지원

경험 조각 구성 요소는 현지화된 사이트 구조에 적응형이며 페이지의 현지화를 기반으로 적절한 경험 조각을 렌더링합니다. 이렇게 하려면 경험 조각이 다음 조건을 충족해야 합니다.

  • 경험 조각 구성 요소가 템플릿에 추가됩니다.
  • 이 템플릿은 /content/<site> 아래의 현지화된 구조에 속하는 새 컨텐츠 페이지를 만드는 데 사용됩니다.
  • 컨텐츠 페이지에서 참조되는 경험 조각은 동일한 구성 요소 이름을 사용하여 /content/<site> 아래의 사이트와 동일한 패턴을 따르는 /content/experience-fragments 아래의 현지화된 경험 조각 구조의 일부입니다.

이 경우 현재 페이지와 동일한 현지화(언어, 블루프린트 또는 live copy)를 사용하는 조각이 템플릿의 일부로 렌더링됩니다.

이 동작은 템플릿에 추가된 경험 조각 구성 요소로 제한됩니다. 개별 컨텐츠 페이지에 추가된 경험 조각 구성 요소는 구성 요소 내에 구성된 정확한 경험 조각 표현물을 렌더링합니다.

컨텐츠가 다음과 유사하다고 가정합니다.

/content
+-- experience-fragments
   \-- wknd
      +-- language-masters
      +-- us
         +-- en
            +-- footerTextXf
            \-- headerTextXf
         \-- es
            +-- footerTextXf
            \-- headerTextXf
      \-- ch
         +-- de
            +-- footerTextXf
            \-- headerTextXf
         +-- fr
            +-- footerTextXf
            \-- headerTextXf
         \-- it
            +-- footerTextXf
            \-- headerTextXf
+-- wknd
   +-- language-masters
   +-- us
      +-- en
      \-- es
   +-- ch
      +-- de
      +-- fr
      \-- it
+-- wknd-events
\-- wknd-shop

/content/experience-fragments/wknd 아래의 구조는 /content/wknd 구조를 미러링합니다.

이 경우 경험 조각 구성 요소 /content/experience-fragments/wknd/us/en/footerTextXf 이 템플릿에 배치되면 해당 템플릿을 기반으로 작성된 현지화된 페이지가 현지화된 컨텐츠 페이지에 해당하는 현지화된 경험 조각을 자동으로 렌더링합니다.

따라서 동일한 템플릿을 사용하는 /content/wknd/ch/de 아래의 컨텐츠 페이지로 이동하면 /content/experience-fragments/wknd/us/en/footerTextXf 대신 /content/experience-fragments/wknd/ch/de/footerTextXf이 렌더링됩니다.

대체

경험 조각 구성 요소는 다음 순서로 해당 현지화된 구성 요소를 찾습니다.

  1. 먼저 언어 루트를 찾으려고 합니다.
  2. 찾을 수 없으면 블루프린트를 찾습니다.
  3. 찾을 수 없으면 Live Copy를 찾습니다.
  4. 찾을 수 없으면 기본적으로 구성 요소에 구성된 경험 조각으로 설정됩니다.

버전 및 호환성

경험 조각 구성 요소의 현재 버전은 v1이며, 2019년 9월에 핵심 구성 요소 릴리스 2.6.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 및 데이터 레이어 추적에 영향을 줄 수 있습니다.

디자인 대화 상자

디자인 대화 상자에서는 템플릿 작성자가 경험 조각 구성 요소를 배치할 때 설정된 기본 및 경험 조각 구성 요소를 사용하는 컨텐츠 작성자가 사용할 수 있는 옵션을 정의할 수 있습니다.

스타일 탭

경험 조각 구성 요소는 AEM 스타일 시스템을 지원합니다.

이 페이지에서는