Utilisation de conditions de masquage using-hide-conditions

Vous pouvez utiliser des conditions de masquage pour déterminer si une ressource de composant est générée ou non. Par exemple, lorsqu’un créateur ou une créatrice de modèles configure le composant principal composant de liste dans l’éditeur de modèles et décide de désactiver les options pour créer la liste en fonction des pages enfants. La désactivation de cette option dans la boîte de dialogue de conception définit une propriété de sorte que lorsque le rendu du composant de liste est effectué, la condition de masquage est évaluée et l’option d’affichage des pages enfants n’est pas affichée.

Vue d’ensemble overview

Les boîtes de dialogue peuvent devenir complexes et contenir de nombreuses options. Cependant, l’utilisateur ou l’utilisatrice ne pourra peut-être exploiter qu’une petite partie de celles mises à sa disposition. Cela peut entraîner une surcharge des expériences de l’interface utilisateur pour les utilisateurs et utilisatrices.

En utilisant les conditions de masquage, les administrateurs et administratrices, les développeurs et développeuses, et les super-utilisateurs et super-utilisatrices disposent d’un moyen de masquer les ressources en fonction d’un ensemble de règles. Cette fonction leur permet de décider quelles ressources afficher lorsqu’un créateur ou une créatrice modifie le contenu.

Détails relatifs à la mise en œuvre et à l’utilisation implementation-and-usage-details

com.adobe.granite.ui.components.FilteringResourceWrapper est chargé de filtrer les ressources en fonction de l’existence et de la valeur de la propriété granite:hide, située sur le champ à filtrer. L’implémentation de /libs/cq/gui/components/authoring/dialog/dialog.jsp comprend une instance de FilteringResourceWrapper.

L’implémentation utilise l’API ELResolver de Granite et ajoute une variable personnalisée cqDesign via ExpressionCustomizer.

Voici quelques exemples de conditions de masquage sur un nœud de conception situé sous etc/design ou sous la forme d’une politique de contenu.

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

Lors de la définition de votre expression de masquage, tenez compte des points suivants :

Exemple example

Vous trouverez des exemples de conditions de masquage dans AEM et dans les composants principaux en particulier. Par exemple, considérons le composant principal de liste.

En utilisant l’éditeur de modèles, le créateur ou la créatrice de modèles peut définir, dans la boîte de dialogue de conception, les options du composant de liste mises à la disposition du créateur ou de la créatrice de pages. Des options telles que l’autorisation ou non d’une liste statique, d’une liste de pages enfants, d’une liste de pages balisées, etc., peuvent être activées ou désactivées.

Si un créateur ou une créatrice de modèles choisit de désactiver l’option des pages enfants, une propriété de conception est définie et une condition de masquage est évaluée par rapport à cette propriété, ce qui fait que l’option ne s’affiche pas pour le créateur ou la créatrice de la page.