조건 숨기기 사용

마지막 업데이트: 2024년 8월 23일

작성 대상:

  • 관리자
  • 개발자

구성 요소 리소스의 렌더링 여부를 판별하기 위해 숨기기 조건을 사용할 수 있습니다. 예제: 템플릿 작성자가 템플릿 편집기에서 핵심 구성 요소 목록 구성 요소를 구성하고 하위 페이지를 기반으로 목록을 빌드하는 옵션을 비활성화하는 경우입니다. 디자인 대화 상자에서 이 옵션을 비활성화하면 속성이 설정되므로 목록 구성 요소가 렌더링될 때 숨기기 조건이 평가되고 하위 페이지를 표시하는 옵션이 표시되지 않습니다.

개요

대화는 사용자가 원하는 옵션의 일부만 사용할 수 있는 수많은 옵션과 함께 매우 복잡해질 수 있습니다. 이로 인해 사용자에게 압도적인 사용자 인터페이스 경험이 제공될 수 있습니다.

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

NOTE
표현식을 기반으로 리소스를 숨기더라도 ACL 권한은 대체되지 않습니다. 컨텐츠는 편집 가능 상태로 유지되지만 단순히 표시되지 않습니다.

구현 및 사용 세부 정보

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 및 핵심 구성 요소 전체에서 찾을 수 있습니다. 예를 들어 WKND 자습서에서 구현된 목록 핵심 구성 요소를 고려해 보십시오.

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

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

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

    목록 구성 요소 설정

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

    목록 구성 요소 디자인 대화 상자

  3. disableChildren 속성이 true(으)로 설정된 /conf/wknd/settings/wcm/policies/wknd/components/list에 정책 노드가 만들어집니다.

    상태 숨김의 노드 구조

  4. 숨기기 조건은 대화 상자 속성 노드 /libs/core/wcm/components/list/v2/list/cq:dialog/content/items/tabs/items/listSettings/items/columns/items/column/items/listFrom/items/children에서 granite:hide 속성의 값으로 정의됩니다.

    숨기기 조건 평가

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

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

    하위 옵션이 비활성화된 목록 구성 요소

Experience Manager