Konfigurieren mehrerer Editoren für Bearbeitung im Kontext

Sie können den Rich-Text-Editor in Adobe Experience Manager so konfigurieren, dass er über mehrere integrierte Editoren verfügt. Nach der Konfiguration können Sie den entsprechenden Inhalt auswählen und den passenden Editor öffnen.

Ein bestimmter Editor für Bearbeitung im Kontext

Mehrere Editoren konfigurieren

Um die Verwendung mehrerer Editoren für Bearbeitung in Kontext zu ermöglichen, wurde die Struktur des Knotentyps cq:InplaceEditingConfig um die Definition des Knotentyps cq:ChildEditorConfig erweitert.

Beispiel:

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

Gehen Sie wie folgt vor, um mehrere Editoren zu konfigurieren:

  1. Auf dem Knoten cq:inplaceEditing (vom Typ cq:InplaceEditingConfig) definieren die folgenden Eigenschaften:

    • Name:editorType
    • Typ: String
    • Wert: hybrid
  2. Erstellen Sie unter diesem Knoten einen Knoten:

    • Name: cq:ChildEditors
    • Typ: nt:unstructured
  3. under cq:childEditors erstellen Sie für jeden Editor im Kontext einen Knoten:

    • Name: Der Name jedes Knotens ist der Name der Eigenschaft, die er darstellt, wie bei Ablagezielen. Zum Beispiel image und text.
    • Typ: cq:ChildEditorConfig
    HINWEIS

    Es besteht eine Korrelation zwischen den definierten Ablagezielen und den untergeordneten Editoren. Der Name der cq:ChildEditorConfig -Knoten wird als Ablageziel-ID betrachtet, die als Parameter für den ausgewählten untergeordneten Editor verwendet werden kann. Wenn der bearbeitbare Unterbereich keine Ablagezielgruppe hat, z. B. in einer Textkomponente, wird der Name des untergeordneten Editors weiterhin als ID zur Identifizierung des entsprechenden bearbeitbaren Bereichs betrachtet.

  4. Auf jedem dieser Knoten (cq:ChildEditorConfig) definieren die Eigenschaften:

    • Name: type.

    • Wert: den Namen des registrierten Bearbeiters; Beispiel: image und text.

    • Name: title.

    • Wert: Der Titel, der in der Komponentenauswahlliste der verfügbaren Editoren angezeigt wird. Zum Beispiel Image und Text.

Zusätzliche Konfiguration für Rich-Text-Editoren

Die Konfiguration mehrerer Rich-Text-Editoren unterscheidet sich etwas vom zuvor beschriebenen Verfahren, da Sie jede einzelne RTE-Instanz separat konfigurieren können. Weitere Informationen finden Sie unter Konfigurieren des Rich-Text-Editors. Um mehrere RTE zu verwenden, erstellen Sie eine Konfiguration für jeden integrierten RTE. Adobe empfiehlt die Erstellung des neuen Konfigurationsknotens unter cq:InplaceEditingConfig da jeder einzelne RTE eine andere Konfiguration haben kann. Erstellen Sie unter dem neuen Knoten jede einzelne RTE-Konfiguration.

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

Für Rich-Text-Editoren wird jedoch die Eigenschaft configPath unterstützt, wenn es nur eine Instanz des Text-Editors (bearbeitbarer Unterbereich) in der Komponente gibt. Diese Verwendung von configPath wird bereitgestellt, um die Abwärtskompatibilität mit älteren Dialogfeldern der Benutzeroberfläche der Komponente zu unterstützen.

VORSICHT

Benennen Sie den RTE-Konfigurationsknoten nicht mit config. Andernfalls sind die RTE-Konfigurationen nur für die Administratoren und nicht für die Benutzer in der Gruppe verfügbar content-author.

Codebeispiele

Den Code dieser Seite finden Sie unter Projekt aem-authoring-hybrideditors auf GitHub. Sie können das gesamte Projekt als ein ZIP-Archiv.

Hinzufügen eines Editors für Bearbeitung im Kontext

Allgemeine Informationen zum Hinzufügen eines Editors für Bearbeitung im Kontext finden Sie im Dokument Anpassen der Seitenbearbeitung.

Auf dieser Seite