숨기기 조건 사용

숨기기 조건을 사용하여 구성 요소 리소스가 렌더링되었는지 확인할 수 있습니다. 템플릿 작성자가 템플릿 편집기에 핵심 구성 요소 목록 구성 요소를 구성하고 하위 페이지를 기준으로 목록을 작성하는 옵션을 비활성화하기로 결정하는 경우가 이에 해당됩니다. 디자인 대화 상자에서 이 옵션을 비활성화하면 목록 구성 요소를 렌더링할 때 숨기기 조건이 평가되고 하위 페이지 표시 옵션이 표시되지 않도록 속성이 설정됩니다.

개요

사용자가 원하는 옵션 중 일부만 사용할 수 있는 다양한 옵션을 사용하여 대화 상자가 매우 복잡해질 수 있습니다. 이로 인해 사용자에게 사용자 인터페이스 경험이 크게 늘어날 수 있습니다.

숨기기 조건을 사용하면 관리자, 개발자 및 수퍼 사용자는 규칙 세트를 기반으로 리소스를 숨길 수 있습니다. 이 기능을 사용하면 작성자가 컨텐츠를 편집할 때 표시할 리소스를 결정할 수 있습니다.

구현 및 사용 세부 정보

com.adobe.granite.ui.components.FilteringResourceWrapper 는 필터링할 필드에 있는 granite:hide 속성의 존재 및 값을 기반으로 리소스를 필터링하는 책임을 집니다. /libs/cq/gui/components/authoring/dialog/dialog.jsp 구현에 FilteringResourceWrapper. 인스턴스가 포함되어 있습니다.

구현은 Granite ELResolver API를 사용하고 ExpressionCustomizer를 통해 cqDesign 사용자 지정 변수를 추가합니다.

다음은 etc/design 아래 또는 컨텐트 정책으로 있는 디자인 노드의 숨기기 조건의 몇 가지 예입니다.

${cqDesign.myProperty}
${!cqDesign.myProperty}
${cqDesign.myProperty == 'someText'}
${cqDesign.myProperty != 'someText'}
${cqDesign.myProperty == true}
${cqDesign.myProperty == true}
${cqDesign.property1 == 'someText' && cqDesign.property2 || cqDesign.property3 != 1 || header.myHeader}

숨기기 표현식을 정의할 때는 다음 사항을 염두에 두십시오.

• 유효하려면 속성이 발견되는 범위(예:cqDesign.myProperty).
• 값은 읽기 전용입니다.
• 함수(필요한 경우)는 서비스가 제공하는 특정 세트로 제한되어야 합니다.

예

숨기기 조건의 예제는 AEM 및 핵심 구성 요소에서 찾을 수 있습니다. 예를 들어 목록 핵심 구성 요소를 고려하십시오.

템플릿 작성자는 템플릿 편집기를 사용하여 페이지 작성자가 사용할 수 있는 목록 구성 요소의 옵션을 디자인 대화 상자에서 정의할 수 있습니다. 목록을 정적 목록으로 허용할지 여부, 하위 페이지 목록, 태그 있는 페이지 목록 등과 같은 옵션. 활성화 또는 비활성화할 수 있습니다.

템플릿 작성자가 하위 페이지 옵션을 비활성화하도록 선택하면 디자인 속성이 설정되고 숨기기 조건이 평가되어 페이지 작성자에 대해 옵션이 렌더링되지 않습니다.

1. 기본적으로 페이지 작성자는 목록 핵심 구성 요소를 사용하여 하위 페이지 옵션을 선택하여 하위 페이지를 사용하여 목록을 만들 수 있습니다.

   

2. 목록 핵심 구성 요소의 디자인 대화 상자에서 템플릿 작성자는 하위 항목 비활성화 옵션을 선택하여 하위 페이지를 기준으로 목록을 생성하는 옵션이 페이지 작성자에게 표시되지 않게 할 수 있습니다.

   

3. 정책 노드는 /conf/we-retail/settings/wcm/policies/weretail/components/content/list 아래에 disableChildren 속성이 true로 설정된 상태로 만들어집니다.

4. 숨기기 조건은 대화 상자 속성 노드 /conf/we-retail/settings/wcm/policies/weretail/components/content/list에 있는 granite:hide 속성의 값으로 정의됩니다.

   

5. disableChildren의 값이 디자인 구성에서 가져오며 ${cdDesign.disableChildren} 식이 false로 평가됩니다. 즉, 옵션이 구성 요소의 일부로 렌더링되지 않습니다.

   숨기기 표현식은 여기에서 GitHub](https://github.com/Adobe-Marketing-Cloud/aem-core-wcm-components/blob/master/content/src/content/jcr_root/apps/core/wcm/components/list/v1/list/_cq_dialog/.content.xml#L40)에서 granite:hide 속성 [의 값으로 볼 수 있습니다.

6. 목록 구성 요소를 사용할 때 하위 페이지 옵션이 더 이상 페이지 작성자에 대해 렌더링되지 않습니다.