Experience League

검색 종료

Experience Cloud

Document Cloud

장식 태그

웹 페이지의 구성 요소를 렌더링할 때 HTML 요소를 생성하여 자체에 렌더링된 구성 요소를 둘러쌀 수 있습니다. 이 기능은 주로 두 가지 목적으로 사용됩니다.

구성 요소는 HTML 요소로 래핑된 경우에만 편집할 수 있습니다.
래핑 요소는 다음을 제공하는 HTML 클래스를 적용하는 데 사용됩니다.
- 레이아웃 정보
- 스타일 정보

개발자를 위해 AEM에서는 포함된 구성 요소를 감싸는 데코레이션 태그를 제어하는 분명하고 단순한 로직을 제공합니다. 데코레이션 태그가 렌더링되는지 여부 및 방법은 이 페이지에서 설명하는 두 가지 요소의 조합으로 정의됩니다.

구성 요소 자체는 속성 세트로 장식 태그를 구성할 수 있습니다.
구성 요소(HTL, JSP, 디스패처 등)가 포함된 스크립트는 포함 매개 변수를 사용하여 데코레이션 태그의 측면을 정의할 수 있습니다.

구성 요소 컨트롤

다음 속성 및 노드를 구성 요소에 적용하여 해당 데코레이션 태그의 동작을 제어할 수 있습니다.

cq:noDecoration {boolean}: 이 속성은 구성 요소에 추가할 수 있으며 true 값을 사용하면 AEM에서 구성 요소 위에 래퍼 요소를 생성하지 않습니다.
cq:htmlTagnode: 이 노드는 구성 요소 아래에 추가할 수 있으며 다음 속성을 가질 수 있습니다.
- cq:tagName {String}: 기본 DIV 요소 대신 구성 요소를 래핑하는 데 사용할 사용자 지정 HTML 태그를 지정하는 데 사용할 수 있습니다.
- class {String}: 래퍼에 추가할 css 클래스 이름을 지정하는 데 사용할 수 있습니다.
- 다른 속성 이름은 제공된 것과 동일한 문자열 값을 갖는 HTML 속성으로 추가됩니다.

스크립트 컨트롤

그러나 래퍼 동작은 HTL 또는 JSP가 요소를 포함하는 데 사용되는지 여부에 따라 다릅니다.

HTL

일반적으로 HTL의 래퍼 동작은 다음과 같이 요약할 수 있습니다.

기본적으로 렌더링되는 래퍼 DIV는 없습니다(단지 data-sly-resource="foo" 실행 시).
모든 wcm-mode(작성자 및 게시 모두에서 비활성화됨, 미리 보기, 편집) 동일하게 렌더링됩니다.

또한 래퍼의 동작을 완벽하게 제어할 수 있습니다.

HTL 스크립트는 래퍼 태그의 결과 비헤이비어를 완벽하게 제어합니다.
구성 요소 속성(예: cq:noDecoration 및 cq:tagName)도 래퍼 태그를 정의할 수 있습니다.

HTL 스크립트에서 래퍼 태그의 비헤이비어와 관련 로직을 완벽하게 제어할 수 있습니다.

HTL에서의 개발에 대한 자세한 내용은 HTL 설명서를 참조하십시오.

의사 결정 트리

이 결정 트리는 래퍼 태그의 동작을 결정하는 논리를 요약합니다.

chlimage_1-75

사용 사례

다음 3가지 사용 사례에서는 래퍼 태그가 처리되는 방식에 대한 예와 래퍼 태그의 원하는 비헤이비어를 간단하게 제어하는 방법을 보여 줍니다.

다음의 모든 예는 컨텐츠 구조 및 구성 요소를 가정합니다.

/content/test/
  @resourceType = "test/components/one"
  child/
    @resourceType = "test/components/two"

/apps/test/components/
  one/
    one.html
  two/
    two.html
    cq:htmlTag/
      @cq:tagName = "article"
      @class = "component-two"

사용 사례 1:코드 재사용에 대한 구성 요소 포함

가장 일반적인 사용 사례는 구성 요소에 코드 재사용에 대한 다른 구성 요소가 포함된 경우입니다. 이 경우 포함된 구성 요소는 자체 도구 모음과 대화 상자를 사용하여 편집할 수 없도록 해야 하므로 래퍼가 필요하지 않으며 구성 요소의 cq:htmlTag은 무시됩니다. 기본 동작으로 간주할 수 있습니다.

one.html: <sly data-sly-resource="child"></sly>

two.html: Hello World!

결과 출력: /content/test.html:

Hello World!

예를 들어 이미지를 표시하는 핵심 이미지 구성 요소를 포함하는 구성 요소가 될 수 있습니다. 일반적으로 합성 리소스를 사용하여 가상 하위 구성 요소를 포함하는 구성 요소는 구성 요소가 가질 모든 속성을 나타내는 모든 속성을 나타내는 데이터-슬라이로 Map 객체로 전달하여 이루어집니다.

사용 사례 2:편집 가능한 구성 요소 포함

또 다른 일반적인 사용 사례는 컨테이너 구성 요소에 레이아웃 컨테이너와 같은 편집 가능한 하위 구성 요소가 포함되어 있는 경우입니다. 이 경우 포함되Child는 편집기가 작동하려면 래퍼가 필요합니다(명시적으로 cq:noDecoration 속성으로 비활성화하지 않은 경우).

포함된 구성 요소는 이 경우에 독립적인 구성 요소이므로 편집기가 작업하고 적용할 레이아웃 및 스타일을 정의하려면 래퍼 요소가 필요합니다. 이 동작을 트리거하려면 decoration=true 옵션이 있습니다.

one.html: <sly data-sly-resource="${'child' @ decoration=true}"></sly>

two.html: Hello World!

결과 출력: /content/test.html:

<article class="component-two">Hello World!</article>

사용 사례 3:사용자 지정 동작

HTL이 명시적으로 제공할 수 있는 가능성으로 쉽게 획득할 수 있는 복잡한 사례는 얼마든지 있습니다.

decorationTagName='ELEMENT_NAME' 래퍼의 요소 이름을 정의하려면
cssClassName='CLASS_NAME' 설정할 CSS 클래스 이름을 정의하려면

one.html: <sly data-sly-resource="${'child' @ decorationTagName='aside', cssClassName='child'}"></sly>

two.html: Hello World!

결과 출력 /content/test.html:

<aside class="child">Hello World!</aside>

JSP

cq:include 또는 sling:include을 사용하여 구성 요소를 포함하는 경우 AEM의 기본 비헤이비어는 DIV를 사용하여 요소를 래핑하는 것입니다. 그러나 다음 두 가지 방법으로 이 래핑을 사용자 지정할 수 있습니다.

AEM에 cq:noDecoration을(를) 사용하여 구성 요소를 래핑하지 않도록 명시적으로 지정합니다.
사용자 지정 HTML 태그를 사용하여 cq:htmlTag/ cq:tagName 또는 decorationTagName를 사용하여 구성 요소를 래핑합니다.