조건 숨기기 사용 using-hide-conditions
구성 요소 리소스의 렌더링 여부를 판별하기 위해 숨기기 조건을 사용할 수 있습니다. 예제: 템플릿 작성자가 템플릿 편집기에서 핵심 구성 요소 목록 구성 요소를 구성하고 하위 페이지를 기반으로 목록을 빌드하는 옵션을 비활성화하는 경우입니다. 디자인 대화 상자에서 이 옵션을 비활성화하면 목록 구성 요소가 렌더링될 때 숨기기 조건이 평가되고 하위 페이지 표시 옵션이 표시되지 않도록 속성이 설정됩니다.
개요 overview
대화 상자는 사용자가 원하는 옵션의 일부만 사용할 수 있는 다양한 옵션으로 복잡해질 수 있습니다. 이로 인해 사용자에게 압도적인 사용자 인터페이스 경험이 제공될 수 있습니다.
관리자, 개발자 및 수퍼 유저는 숨기기 조건을 사용하여 규칙 세트에 따라 리소스를 숨길 수 있습니다. 이 기능을 사용하면 작성자가 콘텐츠를 편집할 때 표시할 리소스를 결정할 수 있습니다.
구현 및 사용 세부 정보 implementation-and-usage-details
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
). - 값은 읽기 전용입니다.
- 함수(필요한 경우)는 서비스에서 제공하는 지정된 세트로 제한해야 합니다.
예 example
숨기기 조건의 예는 특히 AEM 및 핵심 구성 요소 전체에서 찾을 수 있습니다. 예를 들어 목록 핵심 구성 요소를 고려해 보십시오.
템플릿 편집기를 사용하여템플릿 작성자는 디자인 대화 상자에서 페이지 작성자가 사용할 수 있는 목록 구성 요소의 옵션을 정의할 수 있습니다. 정적 목록, 하위 페이지 목록, 태그가 지정된 페이지 목록 등을 허용할지 여부와 같은 옵션을 활성화하거나 비활성화할 수 있습니다.
템플릿 작성자가 하위 페이지 옵션을 비활성화하도록 선택하면 디자인 속성이 설정되고 숨기기 조건이 평가되어 페이지 작성자에 대해 옵션이 렌더링되지 않습니다.
-
기본적으로 페이지 작성자는 하위 페이지 옵션을 선택하여 목록 핵심 구성 요소를 사용하여 하위 페이지를 사용하는 목록을 만들 수 있습니다.
-
템플릿 작성자는 목록 핵심 구성 요소의 디자인 대화 상자에서 하위 항목 비활성화 옵션을 선택하여 하위 페이지를 기반으로 목록을 생성하는 옵션이 페이지 작성자에게 표시되지 않도록 할 수 있습니다.
-
disableChildren
속성이true
(으)로 설정된/conf/we-retail/settings/wcm/policies/weretail/components/content/list
에 정책 노드가 만들어집니다. -
숨기기 조건은 대화 상자 속성 노드
/conf/we-retail/settings/wcm/policies/weretail/components/content/list
에서granite:hide
속성의 값으로 정의됩니다. -
disableChildren
의 값이 디자인 구성에서 가져오고 식${cqDesign.disableChildren}
이(가)false
(으)로 평가됩니다. 즉, 옵션이 구성 요소의 일부로 렌더링되지 않습니다.GitHub에서
granite:hide
속성 의 값으로 숨기기 식을 볼 수 있습니다. -
목록 구성 요소를 사용할 때 하위 페이지 옵션이 더 이상 페이지 작성자에 대해 렌더링되지 않습니다.