Personnaliser les vues des propriétés de la page

Chaque page comporte un ensemble de properties qui peuvent être affichées et modifiées par les utilisateurs ; certaines sont requises lors de la création de la page (création d’une vue), d’autres peuvent être affichées et modifiées ultérieurement (modification d’une vue). Ces propriétés de page sont définies et mises à la disposition des utilisateurs dans la boîte de dialogue (cq:dialog) du composant de page approprié.

Le statut par défaut de chaque propriété de la page est :

• masqué dans la vue de création (par exemple, Créer une page assistant)

• disponible dans la vue d’édition (par exemple, Afficher les propriétés)

Les champs doivent être configurés spécifiquement si une modification est requise. Pour ce faire, utilisez les propriétés de noeud appropriées :

• Propriété de page à rendre disponible dans la vue de création (par exemple : Créer une page assistant) :

  • Nom : cq:showOnCreate
  • Type : Boolean

• Propriété de page à mettre à disposition dans la vue d’édition (par exemple : Affichage/Modifier) Propriétés ) :

  • Nom : cq:hideOnEdit
  • Type : Boolean

Reportez-vous, par exemple, aux paramètres des champs regroupés sous l’onglet Autres titres et description de l’onglet De base du composant Page de base. Ils sont visibles dans l’assistant Créer une page, étant donné que cq:showOnCreate a été défini sur true :

/libs/foundation/components/page/cq:dialog/content/items/tabs/items/basic/items/column/items/moretitles

Configurer vos propriétés de page

Vous pouvez également configurer les champs disponibles en configurant la boîte de dialogue de votre composant de page et en appliquant les propriétés de noeud appropriées.

Par exemple, l’assistant Créer une page affiche, par défaut, les champs regroupés sous Autres titres et description. Pour masquer ces derniers, définissez la configuration suivante :

1. Créez votre composant de page sous /apps.

2. Créez un remplacement (à l’aide de la méthode dialog diff fournie par Sling Resource Merger) pour la section basic de votre composant de page ; par exemple :

   <your-page-component>/cq:dialog/content/items/tabs/items/basic
   

   REMARQUE

   Pour référence :

   /libs/wcm/foundation/components/basicpage/v1/basicpage/cq:dialog

   Cependant, vous ne devez rien modifier dans le chemin /libs.

   En effet, le contenu de /libs est remplacé dès que vous mettez à niveau votre instance (et risque de l’être si vous appliquez un correctif ou un Feature Pack).

   La méthode recommandée pour la configuration et d’autres modifications est la suivante :

   1. Recréez l’élément requis (c’est-à-dire, tel qu’il existe dans /libs) sous /apps
   2. Apportez les modifications désirées dans /apps.

3. Définissez la propriété path sur basic pour pointer vers le remplacement de l’onglet de base (voir également l’étape suivante). Par exemple :

   /apps/demos/components/page/tabs/basic
   

4. Créez un remplacement de la section basic - moretitles à l’emplacement correspondant ; par exemple :

   /apps/demos/components/page/tabs/basic/items/column/items/moretitles
   

5. Appliquez la propriété de nœud appropriée :

   • Nom : cq:showOnCreate
   • Type : Boolean
   • Valeur : false

   La variable Autres titres et description ne s’affichera plus dans la section Créer une page assistant.

Exemple de configuration des propriétés de page

Cet exemple illustre la technique dialog diff de Sling Resource Merger ; y compris l’utilisation de sling:orderBefore. Il illustre également l’utilisation de cq:showOnCreate et de cq:hideOnEdit.

CODE SUR GITHUB

Vous pouvez trouver le code de cette page sur GitHub.

• Ouvrez le projet aem-authoring-extension-page-dialog sur GitHub.