경험 조각 구성 요소 experience-fragment-component

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
핵심 구성 요소

작성 대상:

개발자
관리자
사용자

콘텐츠 작성자는 핵심 구성 요소의 경험 조각 구성 요소를 통해 페이지에 경험 조각을 배치하면서 현지화된 사이트 구조를 지원할 수 있습니다.

사용량 usage

콘텐츠 작성자는 핵심 구성 요소의 경험 조각 구성 요소를 통해 기존 경험 조각 변형을 선택하여 콘텐츠 페이지에 배치할 수 있습니다. 경험 조각 구성 요소도 현지화된 사이트 구조를 지원합니다.

구성 대화 상자에서 구성 요소의 속성을 정의할 수 있습니다.
구성 요소를 페이지에 추가하는 경우 디자인 대화 상자에서 구성 요소의 기본값을 정의할 수 있습니다.

버전 및 호환성 version-and-compatibility

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

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

구성 요소 버전

AEM 6.4

AEM 6.5

AEM as a Cloud Service

호환 가능

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

현지화된 사이트 구조 지원 localized-site-structure

경험 조각 구성 요소는 현지화된 사이트 구조에 적응하고 페이지의 현지화에 따라 해당 경험 조각을 렌더링합니다. 이 작업을 수행하려면 경험 조각은 다음 조건을 충족해야 합니다.

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

이 경우 현지화 기능(언어, 블루프린트 또는 라이브 카피)이 현재 페이지와 같은 조각은 템플릿의 일부로 렌더링됩니다.

이 비헤이비어는 템플릿에 추가된 경험 조각 구성 요소로 제한됩니다. 개별 콘텐츠 페이지에 추가된 경험 조각 구성 요소를 사용하여 정확한 경험 조각 렌디션을 렌더링하고 구성 요소 내부에 구성합니다.

경험 조각 구성 요소의 현지화 기능이 어떻게 작동하는지 사례를 알고 싶다면 아래 섹션을 참조하십시오.
핵심 구성 요소의 현지화 기능이 어떻게 서로 작동하는지 사례를 알고 싶다면 핵심 구성 요소의 현지화 기능을 참조하십시오.

예 example

콘텐츠의 형태가 다음과 같습니다.

/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가 렌더링됩니다.