Documentation AEM 6.4 Guide de développement

Configuration de plusieurs éditeurs statiques configure-multiple-in-place-editors

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

Rubriques :
Developing

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.

Vous pouvez configurer l’éditeur de texte enrichi dans Adobe Experience Manager afin qu’il dispose de plusieurs éditeurs statiques. Une fois le composant configuré, vous pouvez sélectionner le contenu approprié et ouvrir l’éditeur adéquat.

Un éditeur statique spécifique

Configuration de plusieurs éditeurs configure-multiple-editors

Pour qu’il soit possible d’activer plusieurs éditeurs statiques, la structure d’un type de nœud cq:InplaceEditingConfig a été optimisée avec la définition du type de nœud cq:ChildEditorConfig.

Par exemple :

   /**
       * Configures in-place editing of a component.
       *
       * @prop active true to activate in-place editing for the component.
       * @prop editorType ID of in-place editor to use.
       * @prop cq:childEditors collection of {@link cq:ChildEditorConfig} nodes.
       * @prop configPath path to editor's config (optional).
       * @node config editor's config (used if no configPath is specified; optional).
     */
    [cq:InplaceEditingConfig] > nt:unstructured
      - active (boolean)
      - editorType (string)
      + cq:childEditors (nt:base) = nt:unstructured
      - configPath (string)
      + config (nt:unstructured) = nt:unstructured

    /**
      * Configures one child editor for a sub-component. The name of the this node is
      * used as DD ID.
      *
      * @prop type type of the inline editor. For example, ["image"].
      * @prop title Title of the inline editor.
      * @prop icon Icon to represent the inline editor.
    */
    [cq:ChildEditorConfig] > nt:unstructured
      orderable
      - type (string)
      - title (string)

Pour configurer plusieurs éditeurs, procédez comme suit :

Sur le nœud cq:inplaceEditing (de type cq:InplaceEditingConfig), définissez les propriétés suivantes :
- Nom : editorType
- Type : String
- Valeur : hybrid
Créez un nœud sous celui-ci :
- Nom : cq:ChildEditors
- Type : nt:unstructured

Sous le nœud cq:childEditors, créez un nœud pour chaque éditeur statique :

Nom : le nom de chaque nœud est celui de la propriété qu’il représente, comme avec les cibles de dépôt. Par exemple, image et text.
Type : cq:ChildEditorConfig

note note

note note
NOTE
Il existe une corrélation entre les cibles de dépôt définies et les éditeurs enfants. Le nom du nœud `cq:ChildEditorConfig` est considéré comme l’ID de la cible de dépôt à utiliser en tant que paramètre pour l’éditeur enfant sélectionné. Si la sous-zone modifiable ne comporte pas de cible de dépôt, par exemple comme avec un composant texte, le nom de l’éditeur enfant est toujours considéré comme un moyen d’identifier la zone modifiable correspondante.

NOTE

Il existe une corrélation entre les cibles de dépôt définies et les éditeurs enfants. Le nom du nœud cq:ChildEditorConfig est considéré comme l’ID de la cible de dépôt à utiliser en tant que paramètre pour l’éditeur enfant sélectionné. Si la sous-zone modifiable ne comporte pas de cible de dépôt, par exemple comme avec un composant texte, le nom de l’éditeur enfant est toujours considéré comme un moyen d’identifier la zone modifiable correspondante.

Définissez les propriétés suivantes sur chacun de ces nœuds (cq:ChildEditorConfig) :
- Nom : type
- Valeur : nom de l’éditeur statique enregistré ; par exemple, image et text.
- Nom : title
- Valeur : titre affiché dans la liste de sélection des composants des éditeurs disponibles. Par exemple, Image et Text.

Configuration supplémentaire pour les éditeurs de texte enrichi (RTE) additional-configuration-for-rich-text-editors

La configuration des éditeurs de texte enrichi est légèrement différente, dans la mesure où vous pouvez configurer chaque instance RTE séparément. Pour plus d’informations, consultez la section configuration de l’éditeur de texte enrichi. Pour disposer de plusieurs éditeurs de texte enrichi, vous devez configurer chaque éditeur statique. Adobe recommande de créer le nœud de configuration sous cq:InplaceEditingConfig car chaque éditeur de texte enrichi peut avoir une configuration différente. Sous le nouveau nœud, définissez chaque configuration RTE.

    texttext
        cq:dialog
        cq:editConfig
            cq:inplaceEditing
                cq:childEditors
                    someconfig
                        text1
                            rtePlugins
                        text2
                            rtePlugins

NOTE

Cependant, dans le cas de l’éditeur de texte enrichi, la propriété configPath est prise en charge lorsque le composant ne contient qu’une seule instance de l’éditeur (sous-zone modifiable). Cette utilisation de configPath permet de garantir la rétrocompatibilité avec les boîtes de dialogue du composant conçues pour l’ancienne interface utilisateur.

CAUTION

Ne donnez pas le nom config au nœud de configuration de l’éditeur de texte enrichi (RTE). Autrement, les configurations de l’éditeur de texte enrichi ne sont disponibles que pour les administrateurs, et non pour les utilisateurs du groupe content-author.

Exemples de code code-samples

Vous trouverez le code de cette page dans le projet aem-authoring-hybrideditors sur GitHub. Vous pouvez télécharger l’intégralité du projet sous la forme d’une archive ZIP.

Ajout d’un éditeur statique add-an-in-place-editor

Pour obtenir des informations d’ordre général sur l’ajout d’un éditeur statique, consultez le document Personnalisation de la création de pages.

recommendation-more-help

2315f3f5-cb4a-4530-9999-30c8319c520e