DocumentationAEM 6.4Guide de développement

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Developer
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Chaque page comporte un ensemble de properties qui peuvent être affichés et modifiés 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é.

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é dans la vue de création (assistant Créer une page, par exemple) ;

  • disponible dans la vue 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 les propriétés de noeud appropriées :

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

    • Nom : cq:showOnCreate
    • Type : Boolean

  • Propriété de page qui doit être disponible dans la vue 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 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 :

    code language-xml 
    <your-page-component>/cq:dialog/content/items/tabs/items/basic
    note note
    NOTE
    Pour référence :
    code language-none 
    /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

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

NOTE
Lors de la configuration des propriétés de page à utiliser avec des Live Copies, voir 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
2315f3f5-cb4a-4530-9999-30c8319c520e