Använda Dölj villkor using-hide-conditions

Dölj villkor kan användas för att avgöra om en komponentresurs återges eller inte. Ett exempel på detta är när en mallskapare konfigurerar kärnkomponenten listkomponent i mallredigerare och bestämmer sig för att inaktivera alternativen för att skapa listan baserat på underordnade sidor. Om du inaktiverar det här alternativet i designdialogrutan anges en egenskap så att när listkomponenten återges utvärderas dolda villkor och alternativet att visa underordnade sidor inte visas.

Översikt overview

Dialogrutor kan bli mycket komplexa med många alternativ för användaren, som kanske bara använder en del av de alternativ som han/hon har till sitt förfogande. Detta kan leda till en överväldigande upplevelse av användargränssnittet.

Genom att använda dolda villkor kan administratörer, utvecklare och superanvändare dölja resurser baserat på en uppsättning regler. Med den här funktionen kan de bestämma vilka resurser som ska visas när en författare redigerar innehåll.

Implementerings- och användningsinformation implementation-and-usage-details

com.adobe.granite.ui.components.FilteringResourceWrapper är ansvarig för att filtrera resurserna baserat på förekomsten och värdet av granite:hide -egenskap, som finns i det fält som ska filtreras. Genomförandet av /libs/cq/gui/components/authoring/dialog/dialog.jsp innehåller en instans av FilteringResourceWrapper.

Implementeringen utnyttjar Graniten ELResolver API och lägger till en cqDesign egen variabel via ExpressionCustomizer.

Här är några exempel på hur du döljer villkor i en designnod som finns under etc/design eller som en innehållsprincip.

${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}

När du definierar ditt dolda uttryck ska du tänka på:

Exempel example

Exempel på dolda villkor finns i hela AEM och kärnkomponenter särskilt. Tänk dig till exempel listkärnkomponent.

Använda mallredigerarenkan mallskaparen i designdialogrutan definiera vilka alternativ för listkomponenten som är tillgängliga för sidförfattaren. Alternativ som om listan ska kunna vara en statisk lista, en lista med underordnade sidor, en lista med taggade sidor osv. kan aktiveras eller inaktiveras.

Om en mallskapare väljer att inaktivera alternativet för underordnade sidor, ställs en designegenskap in och ett dolt villkor utvärderas mot den, vilket gör att alternativet inte återges för sidförfattaren.