DocumentationAEM 6.5Guide de l’utilisateur

Personnaliser les vues des propriétés de la page customizing-views-of-page-properties

Last update: Thu Apr 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Développeur

Chaque page comporte un ensemble de propriétés qui peuvent être affichées et modifiées par les utilisateurs et utilisatrices ; certaines sont requises lors de la création de la page (mode de création), d’autres peuvent être affichées et modifiées ultérieurement (mode d’édition). 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é.

CAUTION
L’affichage des propriétés de page ne peut pas être personnalisé dans l’interface utilisateur classique.

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

  • masqué en mode de création (assistant Créer une page, par exemple) ;

  • disponible en mode d’édition (Afficher les propriétés, par exemple).

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

  • Propriété de page qui doit être disponible en mode de création (assistant Créer une page, par exemple) :

    • Nom : cq:showOnCreate
    • Type : Boolean

  • Propriété de page qui doit être disponible en mode d’édition (par exemple, l’option Afficher/Modifier les 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
TIP
Consultez le Tutoriel sur l’extension des propriétés de page pour obtenir un guide sur la personnalisation des propriétés de page.

Configurer vos propriétés de page configuring-your-page-properties

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 nœud 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 :

    code language-xml 
    <your-page-component>/cq:dialog/content/items/tabs/items/basic
    note note
    NOTE
    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 (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 :

    code language-xml 
    /apps/demos/components/page/tabs/basic

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

    code language-xml 
    /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 section Autres titres et description ne s’affichera plus dans l’assistant Créer une page.

NOTE
Lors de la configuration des propriétés de page à utiliser avec des Live Copy, consultez Configuration des verrous MSM sur les propriétés de page pour plus d’informations.

Exemple de configuration des propriétés de page sample-configuration-of-page-properties

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.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2