Configurer plusieurs éditeurs sur place

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

Un éditeur statique spécifique

Configurer plusieurs éditeurs

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 noeud cq:inplaceEditing (de type cq:InplaceEditingConfig), définissez les propriétés suivantes :
- Nom : editorType
- Type : String
- Valeur : hybrid
Sous ce noeud, créez un noeud :
- Nom : cq:ChildEditors
- Type : nt:unstructured
Sous le noeud cq:childEditors, créez un noeud pour chaque éditeur statique :
- Nom : Le nom de chaque noeud correspond au nom de la propriété qu’il représente, comme c’est le cas pour les cibles de dépôt. Par exemple, image et text.
- Type : cq:ChildEditorConfig
REMARQUE

Il existe une corrélation entre les cibles de dépôt définies et les éditeurs enfants. Le nom du noeud cq:ChildEditorConfig est considéré comme l’ID de cible de dépôt, à utiliser comme paramètre pour l’éditeur enfant sélectionné. Si la sous-zone modifiable ne comporte pas de cible de dépôt, par exemple, dans un composant de texte, le nom de l’éditeur enfant est toujours considéré comme un identifiant permettant d’identifier la zone modifiable correspondante.
Sur chacun de ces noeuds (cq:ChildEditorConfig), définissez les propriétés :
- Nom: type.
- Valeur : le nom de l'éditeur en place inscrit ; 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

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, voir configuration de l’éditeur de texte enrichi. Pour avoir plusieurs ETC, créez une configuration pour chaque ETC statique. Adobe recommande de créer le nouveau noeud de configuration sous cq:InplaceEditingConfig, car chaque RTE individuel peut avoir une configuration différente. Sous le nouveau noeud, créez chaque configuration RTE individuelle.

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

REMARQUE

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 est fournie pour prendre en charge la compatibilité ascendante avec les anciennes boîtes de dialogue d'interface utilisateur du composant.

ATTENTION

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

Exemples de code

Vous trouverez le code de cette page sur le projet aem-authoring-hybrideditors sur GitHub. Vous pouvez télécharger le projet complet sous la forme d'une archive ZIP.