Configurare più editor locali configure-multiple-in-place-editors

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Sviluppo

Creato per:

Sviluppatore

È possibile configurare l’Editor Rich Text in Adobe Experience Manager in modo che disponga di più editor locali. Una volta configurata, puoi selezionare il contenuto appropriato e aprire l’editor appropriato.

Un editor locale specifico

Configurare più editor configure-multiple-editors

Per abilitare più editor locali, la struttura di un tipo di nodo cq:InplaceEditingConfig è stata migliorata con la definizione di tipo di nodo cq:ChildEditorConfig.

Ad esempio:

   /**
       * 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)

Per configurare più editor, eseguire la procedura seguente:

Nel nodo cq:inplaceEditing (di tipo cq:InplaceEditingConfig) definire le seguenti proprietà:
- Nome:editorType
- Tipo: String
- Valore: hybrid
Crea un nodo sotto questo nodo:
- Nome: cq:ChildEditors
- Tipo: nt:unstructured

Sotto il nodo cq:childEditors, crea un nodo per ogni editor locale:

Nome: il nome di ciascun nodo è il nome della proprietà che rappresenta, come nel caso delle destinazioni di rilascio. Ad esempio, image e text.
Tipo: cq:ChildEditorConfig

note note

note note
NOTE
Esiste una correlazione tra le destinazioni di rilascio definite e gli editor secondari. Il nome del nodo `cq:ChildEditorConfig` viene considerato come ID destinazione di rilascio, da utilizzare come parametro per l'editor figlio selezionato. Se la sottoarea modificabile non ha una destinazione di rilascio, ad esempio, in un componente di testo, il nome dell’editor figlio viene comunque considerato un ID per identificare l’area modificabile corrispondente.

NOTE

Esiste una correlazione tra le destinazioni di rilascio definite e gli editor secondari. Il nome del nodo cq:ChildEditorConfig viene considerato come ID destinazione di rilascio, da utilizzare come parametro per l'editor figlio selezionato. Se la sottoarea modificabile non ha una destinazione di rilascio, ad esempio, in un componente di testo, il nome dell’editor figlio viene comunque considerato un ID per identificare l’area modificabile corrispondente.

Su ciascuno di questi nodi (cq:ChildEditorConfig) definisci le proprietà:
- Nome: type.
- Valore: il nome dell'editor locale registrato, ad esempio image e text.
- Nome: title.
- Valore: il titolo visualizzato nell’elenco di selezione dei componenti degli editor disponibili. Ad esempio, Image e Text.

Configurazione aggiuntiva per gli editor Rich Text additional-configuration-for-rich-text-editors

La configurazione di più editor Rich Text è leggermente diversa, in quanto è possibile configurare separatamente ogni singola istanza di RTE. Per ulteriori dettagli, vedere configurare l'editor Rich Text. Per disporre di più editor Rich Text, creare una configurazione per ogni editor Rich Text locale. L'Adobe consiglia di creare il nuovo nodo di configurazione in cq:InplaceEditingConfig in quanto ogni singolo editor Rich Text può avere una configurazione diversa. Nel nuovo nodo creare ogni singola configurazione dell’editor Rich Text.

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

NOTE

Tuttavia, per l'editor Rich Text, la proprietà configPath è supportata quando nel componente è presente una sola istanza dell'editor di testo (sottoarea modificabile). Questo utilizzo di configPath viene fornito per supportare la compatibilità con le versioni precedenti delle finestre di dialogo dell'interfaccia utente del componente.

CAUTION

Non assegnare al nodo di configurazione dell'Editor Rich Text il nome config. In caso contrario, le configurazioni dell'editor Rich Text sono disponibili solo per gli amministratori e non per gli utenti del gruppo content-author.

Esempi di codice code-samples

Puoi trovare il codice di questa pagina nel progetto aem-authoring-hybrideditors su GitHub. Puoi scaricare il progetto completo come archivio ZIP.

Aggiungere un editor locale add-an-in-place-editor

Per informazioni generali sull'aggiunta di un editor locale, vedere il documento personalizzare la creazione delle pagine.

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2