Konfigurieren des Rich-Text-Editors

Letzte Aktualisierung: 2024-01-08

Der Rich-Text-Editor (RTE) bietet Autorinnen und Autoren eine große Bandbreite an Funktionen zum Bearbeiten von Textinhalten. Symbole, Auswahlfelder, Symbolleisten und Menüs werden für eine WYSIWYG-Textbearbeitung bereitgestellt.

Informationen zur Verwendung der Authoring-Funktionen des RTE finden Sie unter Verwenden des Rich-Text-Editors für das Authoring. Der RTE kann konfiguriert werden, um die in den Authoring-Komponenten verfügbaren Funktionen zu aktivieren, zu deaktivieren und zu erweitern. Der folgende Workflow veranschaulicht die empfohlene Reihenfolge für die RTE-Konfigurationsaufgaben in Experience Manager.

Sequenz von Schritten, um das Konfigurieren des RTE zu erlernen

Abbildung: Sequenz von Schritten, um das Konfigurieren des RTE zu erlernen

Grundlegendes zur Touch-optimierten und klassischen Benutzeroberfläche

Die Touch-optimierte Benutzeroberfläche ist die Standard-Benutzeroberfläche für Experience Manager. Adobe hat die Touch-optimierte Benutzeroberfläche mit responsivem Design für die Authoring-Umgebung eingeführt. Die Touch-optimierte Benutzeroberfläche wurde für Touch- und Desktop-Geräte entwickelt. Diese Benutzeroberfläche unterscheidet sich deutlich von der ursprünglichen klassischen Benutzeroberfläche.

Rich-Text-Editor-Symbolleiste in der Touch-optimierten Benutzeroberfläche

Abbildung: Rich-Text-Editor-Symbolleiste in der Touch-optimierten Benutzeroberfläche

Rich-Text-Editor-Symbolleiste in der klassischen Benutzeroberfläche

Abbildung: Rich-Text-Editor-Symbolleiste in der klassischen Benutzeroberfläche

Verschiedene Bearbeitungsmodi

Autoren können Textinhalte in Experience Manager mithilfe der verschiedenen Komponentenmodi erstellen und bearbeiten. Die Symbolleistenoptionen für das Erstellen und Formatieren von Inhalten sowie das Benutzererlebnis von RTE-aktivierten Komponenten in verschiedenen Bearbeitungsmodi variieren je nach RTE-Konfigurationen.

Bearbeitungsmodus Bearbeitungsbereich Für die Aktivierung empfohlene Funktionen Touch-optimierte Benutzeroberfläche Klassische Benutzeroberfläche
Inline Bearbeitung im Kontext für schnelle, geringfügige Änderungen; Formatieren ohne Öffnen eines Dialogfelds Minimale RTE-Funktionen J J
RTE-Vollbild Füllt die gesamte Seite aus Alle erforderlichen RTE-Funktionen J N
Dialogfeld Dialogfeld, das oberhalb des Seiteninhalts angezeigt wird, jedoch nicht die gesamte Seite einnimmt Alle erforderlichen RTE-Funktionen in der klassischen Benutzeroberfläche; Funktionen sollten in der Touch-optimierten Benutzeroberfläche umsichtig aktiviert werden J J
Dialogfeld-Vollbildmodus Wie im Vollbildmodus; enthält neben dem RTE Felder des Dialogfelds Alle erforderlichen RTE-Funktionen J N
HINWEIS

In der Touch-optimierten Benutzeroberfläche ist die Quellbearbeitungsfunktion im Inline-Bearbeitungsmodus nicht verfügbar. Im Vollbildmodus können Sie Bilder nicht per Drag-and-Drop verschieben. Alle anderen Funktionen sind in allen Modi verfügbar.

Inline-Bearbeitung

Beim Öffnen (durch langsames Doppelklicken) kann der Inhalt innerhalb der Seite bearbeitet werden. Dazu steht Ihnen eine kompakte Symbolleiste mit sehr grundlegenden Optionen zur Verfügung.

Inline-Bearbeitung mit einfacher Symbolleiste in der Touch-optimierten Benutzeroberfläche

Abbildung: Inline-Bearbeitung mit einfacher Symbolleiste in der Touch-optimierten Benutzeroberfläche

In der klassischen Benutzeroberfläche ermöglicht ein langsamer Doppelklick auf die Komponente die Inline-Bearbeitung und ein orangefarbener Entwurf hebt den Inhalt hervor. Wenn die Inhaltssuche geöffnet ist, wird oben im Fenster eine Symbolleiste mit den verfügbaren RTE-Formatierungsoptionen angezeigt. Ist der Content Finder nicht geöffnet, werden die Formatierungsoptionen nicht angezeigt und Sie können nur grundlegende Textbearbeitungen vornehmen.

Bearbeitung im Vollbildmodus

Experience Manager-Komponenten können im Vollbildmodus geöffnet werden. Dabei wird der Seiteninhalt überdeckt und der gesamte Bildschirm ausgefüllt. Die Bearbeitung im Vollbildmodus ist quasi eine detaillierte Version der Inline-Bearbeitung, da sie die meisten Bearbeitungsmöglichkeiten bietet. Wenn Sie sich im Inline-Bearbeitungsmodus befinden, kann sie durch Klicken auf rte_fullscreen in der kompakten Symbolleiste geöffnet werden.

Im Dialogfeld-Vollbildmodus stehen neben einer detaillierten RTE-Symbolleiste auch die in einem Dialogfeld verfügbaren Optionen und Komponenten zur Verfügung. Dies gilt nur für ein Dialogfeld, das neben anderen Komponenten einen RTE enthält.

Die detaillierte RTE-Symbolleiste bei der Bearbeitung im Vollbildmodus in der Touch-optimierten Benutzeroberfläche

Abbildung: Die detaillierte RTE-Symbolleiste bei der Bearbeitung im Vollbildmodus in der Touch-optimierten Benutzeroberfläche

Bearbeitung in einem Dialogfeld

Wenn Sie auf eine Komponente doppelklicken, wird ein Dialogfeld zur Bearbeitung des Inhalts geöffnet. Das Dialogfeld wird über der vorhandenen Seite geöffnet. In bestimmten Fällen kann dieses Dialogfeld auch als Popup-Fenster geöffnet werden. Dies ist beispielsweise der Fall, wenn eine Textkomponente Teil einer Spalte in einem mehrspaltigen Seitenlayout ist und zu wenig Platz für die Anzeige des Dialogfelds vorhanden ist.

Dialogfeld-Bearbeitungsmodus in Touch-optimierter Benutzeroberfläche

Abbildung: Dialogfeld-Bearbeitungsmodus in Touch-optimierter Benutzeroberfläche

Dialogfeld in der klassischen Benutzeroberfläche mit einer Symbolleiste zur Bearbeitung

Abbildung: Dialogfeld in der klassischen Benutzeroberfläche mit einer Symbolleiste zur Bearbeitung

Wissenswertes über RTE-Plug-ins und die zugehörigen Funktionen

Die Funktionen werden über eine Reihe von Plug-ins zur Verfügung gestellt, jeweils mit:

  • einer features-Eigenschaft:

    • zur Aktivierung oder Deaktivierung der grundlegenden Funktionalität des jeweiligen Plug-ins verwendet werden kann
    • die über ein standardisiertes Verfahren konfiguriert werden kann;
  • weiteren Eigenschaften und Optionen, die eine spezielle Konfiguration erfordern.

Die grundlegenden RTE-Funktionen werden durch den Wert der Eigenschaft features in einem Knoten aktiviert oder deaktiviert, der spezifisch für das entsprechende Plug-in ist.

In der folgenden Tabelle sind die derzeit verfügbaren Plug-ins aufgelistet, mit Angabe von:

  • Plug-in-IDs mit einem Link zur API-Dokumentation. Die ID wird beim Aktivieren eines Plug-ins als Knotenname verwendet.
  • Zulässige Werte für die Eigenschaft features.
  • Eine Beschreibung der vom Plug-in bereitgestellten Funktion.
Plug-in-ID Funktionen Beschreibung
edit cut copy paste-default paste-plaintext paste-wordhtml Ausschneiden, Kopieren und die drei Einfügen-Modi.
findreplace find replace Suchen und Ersetzen.
format bold italic underline Grundlegende Textformatierung.
image image Grundlegende Bildunterstützung (aus den Inhalten oder dem Content Finder ziehen). Nutzungsverhalten für Autoren kann je nach verwendetem Browser variieren
keys Informationen zum Definieren dieses Werts finden Sie unter Registerkartengröße.
justify justifyleft justifycenter justifyright Absatzausrichtung.
links modifylink unlink anchor Hyperlinks und Anker.
lists ordered unordered indent outdent Über dieses Plug-in werden Einzüge und Listen gesteuert, einschließlich verschachtelter Listen.
misctools specialchars sourceedit Verschiedene Tools gestatten es Autoren, Sonderzeichen einzugeben oder die HTML-Quelle zu bearbeiten. Außerdem können Sie zahlreiche Sonderzeichen hinzufügen, wenn Sie Ihre eigene Liste definieren möchten.
Paraformat Paraformat Folgende Standard-Absatzformate sind verfügbar: „Absatz“, „Überschrift 1“, „Überschrift 2“ und „Überschrift 3“ (<p>, <h1>, <h2> und <h3>). Sie können weitere Absatzformate hinzufügen oder die Liste erweitern.
Rechtschreibprüfung Textcheck Rechtschreibprüfung mit Spracherkennung.
Stile Stile Unterstützung für das Styling mithilfe einer CSS-Klasse. Fügen Sie neue Textstile hinzu, wenn Sie eigene Stile zur Verwendung mit Text hinzufügen oder erweitern möchten.
subsuperscript subscript superscript Erweiterung der grundlegenden Formatierungsoptionen um die Optionen „Hochgestellt“ und „Tiefgestellt“.
table table removetable insertrow removerow insertcolumn removecolumn cellprops mergecells splitcell selectrow selectcolumns Weitere Informationen zum Hinzufügen eigener Stile für komplette Tabellen oder einzelne Zellen finden Sie unter Konfigurieren von Tabellenstilen.
undo undo redo Verlaufsgröße zu Vorgängen zum Rückgängigmachen oder Wiederholen.
HINWEIS

Das Plug-in für den Vollbildmodus wird im Dialogfeldmodus nicht unterstützt. Konfigurieren Sie die Symbolleiste für den Vollbildmodus mithilfe der Einstellung dialogFullScreen.

Grundlegendes zu den Konfigurationspfaden und -speicherorten

Der RTE-Bearbeitungsmodus (und die Benutzeroberfläche), den Sie Ihren Autoren bereitstellen, legt den Speicherort für die Konfigurationsdetails fest, wenn Sie die RTE-Plug-ins aktivieren:

Bearbeitungsmodus Speicherort für Touch-optimierte Benutzeroberfläche Speicherort für klassische Benutzeroberfläche
Inline cq:editConfig/cq:inplaceEditing cq:editConfig/cq:inplaceEditing
Vollbild cq:editConfig/cq:inplaceEditing Nicht zutreffend
Dialogfeld cq:dialog dialog
Dialogfeld im Vollbildmodus cq:dialog Nicht zutreffend
HINWEIS

Benennen Sie den Knoten unter cq:inplaceEditing nicht mit config. Definieren Sie unter dem Knoten cq:inplaceEditing die folgenden Eigenschaften:

  • Name: configPath
  • Typ: String
  • Wert: Pfad des Knotens, der die tatsächliche Konfiguration enthält

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

Konfigurieren Sie die folgenden Eigenschaften, die nur im Dialogfeld-Bearbeitungsmodus in der Touch-optimierten Benutzeroberfläche verfügbar sind:

  • useFixedInlineToolbar: Legen Sie diese boolesche Eigenschaft, die im RTE-Knoten (einer mit „sling:resourceType=cq/gui/components/authoring/dialog/richtext“) definiert ist, auf True fest, um die RTE-Symbolleiste zu fixieren.

    Wenn diese Eigenschaft auf „true“ gesetzt ist, wird die Rich-Text-Bearbeitung standardmäßig beim Ereignis „foundation-contentloaded“ gestartet.

    Um dies zu verhindern, setzen Sie die Eigenschaft customStart auf True und lösen Sie das Ereignis „rte-start“ zum Starten der RTE-Bearbeitung aus. Wenn diese Eigenschaft auf „true“ gesetzt ist, funktioniert das Standardverhalten, d. h. das Starten des RTE bei Klicken, nicht.

  • customStart: Setzen Sie diese boolesche Eigenschaft, die im RTE-Knoten definiert ist, auf True, um den RTE-Startzeitpunkt zu steuern, indem Sie das Ereignis rte-start auslösen.

  • rte-start: Lösen Sie dieses Ereignis bei contenteditable-div des RTE aus, wenn die RTE-Bearbeitung gestartet werden soll. Dies funktioniert nur, wenn customStart auf „true“ gesetzt ist.

Wenn der RTE im Touch-optimierten Dialogfeld verwendet wird, muss die Eigenschaft useFixedInlineToolbar auf „true“ gesetzt werden, um Probleme zu vermeiden.

Anpassen der Bearbeitung im Kontext

Sie können festlegen, mit welchem HTML-Selektor der Text-Editor beginnt, indem Sie die folgenden Eigenschaften konfigurieren:

  • editElementQuery: Wird in cq:InplaceEditingConfig definiert. Diese Eigenschaft wird verwendet, um einen Selektor des HTML-Elements anzugeben, mit dem die Inline-Bearbeitung für die Textkomponente gestartet wird. Wenn sie nicht angegeben ist, wird die Inline-Bearbeitung direkt im HTML-Code der Textkomponente gestartet.
  • textPropertyName: Wird in cq:InplaceEditingConfig definiert. Diese Eigenschaft wird verwendet, um den Namen der Eigenschaft anzugeben, die auf dem Inhaltsknoten gespeichert wird, auf dem der HTML-Wert der Textkomponente nach der Inline-Bearbeitung beibehalten wird.

Die entsprechende Eigenschaft für den Dialogfeldmodus lautet name.

Aktivieren von RTE-Funktionen durch Aktivieren von Plug-ins

RTE-Funktionen werden über eine Reihe von Plug-ins mit jeweils einer Eigenschaft „Funktionen“ bereitgestellt. Sie können die Funktionen so konfigurieren, dass die verschiedenen Funktionen der einzelnen Plug-ins aktiviert oder deaktiviert werden.

Ausführliche Konfigurationen der RTE-Plug-ins finden Sie unter Aktivieren und Konfigurieren der RTE-Plug-ins.

Beispiel: Laden Sie diese Beispielkonfiguration herunter, die die Konfiguration des RTE veranschaulicht. In diesem Paket sind alle Funktionen aktiviert.

HINWEIS

Die Text-Kernkomponente gestattet es Bearbeitern von Vorlagen, viele RTE-Plug-ins in einer grafischen Benutzeroberfläche als Content-Richtlinien zu konfigurieren, sodass keine technische Konfiguration mehr erforderlich ist. Content-Richtlinien können mit RTE-Benutzeroberflächenkonfigurationen verwendet werden, wie in diesem Dokument beschrieben ist.

Weitere Informationen finden Sie unter Einstellungen und Content-Richtlinien der RTE-Benutzeroberfläche Abschnitt dieses Dokuments und Erstellen von Seitenvorlagen und Entwicklerdokumentation für Kernkomponenten.

HINWEIS

Zu Referenzzwecken finden Sie die standardmäßigen Textkomponenten (bereitgestellt im Rahmen einer Standardinstallation) unter:

  • /libs/wcm/foundation/components/text
  • /libs/foundation/components/text

Um eine eigene Textkomponente zu erstellen, kopieren Sie die oben stehende Komponente, anstatt diese Komponenten zu bearbeiten.

RTE-Symbolleiste konfigurieren

Mit AEM können Sie die Benutzeroberfläche für den Rich-Text-Editor für die verschiedenen Bearbeitungsmodi unterschiedlich konfigurieren. Die Standardeinstellungen finden Sie unten. Sie können diese Standardwerte entsprechend Ihren Anforderungen überschreiben. Sie passen nur die Symbolleisteneigenschaften an, die Sie Ihren Autoren zur Verfügung stellen möchten. Sie brauchen nicht alle Symbolleistenkonfigurationen anzugeben.

Um die Symbolleiste für dialogFullScreen zu konfigurieren, verwenden Sie die folgende Beispielkonfiguration.

<uiSettings jcr:primaryType="nt:unstructured">
  <cui jcr:primaryType="nt:unstructured">
    <inline
      jcr:primaryType="nt:unstructured"
      toolbar="[format#bold,format#italic,format#underline,#justify,#lists,links#modifylink,links#unlink,#paraformat]">
      <popovers jcr:primaryType="nt:unstructured">
        <justify
          jcr:primaryType="nt:unstructured"
          items="[justify#justifyleft,justify#justifycenter,justify#justifyright,justify#justifyjustify]"
          ref="justify"/>
        <lists
          jcr:primaryType="nt:unstructured"
          items="[lists#unordered,lists#ordered,lists#outdent,lists#indent]"
          ref="lists"/>
        <paraformat
          jcr:primaryType="nt:unstructured"
          items="paraformat:getFormats:paraformat-pulldown"
          ref="paraformat"/>
      </popovers>
    </inline>
    <dialogFullScreen
      jcr:primaryType="nt:unstructured"
      toolbar="[format#bold,format#italic,format#underline,justify#justifyleft,justify#justifycenter,justify#justifyright,justify#justifyjustify,lists#unordered,lists#ordered,lists#outdent,lists#indent,links#modifylink,links#unlink,table#createoredit,#paraformat,image#imageProps]">
      <popovers jcr:primaryType="nt:unstructured">
        <paraformat
          jcr:primaryType="nt:unstructured"
          items="paraformat:getFormats:paraformat-pulldown"
          ref="paraformat"/>
      </popovers>
    </dialogFullScreen>
    <tableEditOptions
      jcr:primaryType="nt:unstructured"
      toolbar="[table#insertcolumn-before,table#insertcolumn-after,table#removecolumn,-,table#insertrow-before,table#insertrow-after,table#removerow,-,table#mergecells-right,table#mergecells-down,table#mergecells,table#splitcell-horizontal,table#splitcell-vertical,-,table#selectrow,table#selectcolumn,-,table#ensureparagraph,-,table#modifytableandcell,table#removetable,-,undo#undo,undo#redo,-,table#exitTableEditing,-]">
    </tableEditOptions>
  </cui>
</uiSettings>

Für den Inline-Modus und den Vollbildmodus werden verschiedene Benutzeroberflächeneinstellungen verwendet. Mit der Symbolleisteneigenschaft wird verwendet, um die Schaltflächen der Symbolleiste anzugeben.

Wenn die Schaltfläche selbst eine Funktion aufweist (z. B. Bold), wird sie als PluginName#FeatureName angegeben (z. B. links#modifylink).

Wenn es sich bei der Schaltfläche um ein Popover handelt (sie also einige Funktionen eines Plug-ins aufweist), wird sie als #PluginName angegeben (z. B. #format).

Trennzeichen (|) zwischen einer Gruppe von Schaltflächen können mit - angegeben werden.

Der Popup-Knoten im Inline- oder Vollbildmodus enthält eine Liste der verwendeten Popovers. Jeder untergeordnete Knoten unter dem Knoten wird nach dem Plug-in benannt (z. B. „Format“). Er verfügt über eine Eigenschaft „items“, die eine Liste der Funktionen des Plug-ins beinhaltet (z. B. „format#bold“).

Einstellungen für die RTE-Benutzeroberfläche und Content-Richtlinien

Administratoren können die RTE-Optionen mithilfe von Content-Richtlinien steuern, anstatt die Konfiguration wie oben beschrieben durchzuführen. Inhaltsrichtlinien definieren die Designeigenschaften einer Komponente, wenn sie als Teil einer bearbeitbaren Vorlage verwendet wird. Wenn zum Beispiel eine Textkomponente, die den RTE verwendet, mit einer bearbeitbaren Vorlage verwendet wird, kann die Content-Richtlinie definieren, dass die fettgedruckte Option und einige Absatzformatierungsoptionen verfügbar sind. Inhaltsrichtlinien sind wiederverwendbar und können auf mehrere Vorlagen angewendet werden.

Die verfügbaren Optionen im RTE werden von der Benutzeroberflächenkonfiguration abwärts zu den Content-Richtlinien übertragen.

  • Die Benutzeroberflächen-Konfigurationseinstellungen definieren, welche Optionen für die Content-Richtlinien verfügbar sind.
  • Wenn die Benutzeroberflächenkonfiguration des RTE entfernt oder ein Element nicht aktiviert wird, kann die Content-Richtlinie sie nicht konfigurieren.
  • Ein Autor hat nur auf die Funktionen Zugriff, die durch die Benutzeroberflächen-Konfigurationen und Content-Richtlinien zur Verfügung gestellt werden.

Beispielsweise können Sie die Dokumentation zur Text-Kernkomponente sehen.

Anpassen der Zuordnung zwischen Symbolleistenelementen und Befehlen

Sie können die Zuordnung zwischen in der RTE-Symbolleiste angezeigten Coral-Symbolen und den verfügbaren Befehlen anpassen. Sie können keine anderen Symbole als Coral-Symbole verwenden.

  1. Erstellen Sie einen Knoten namens icons unter uiSettings/cui.

  2. Erstellen Sie Knoten für die einzelnen Symbole darunter.

  3. Geben Sie in jedem Knoten ein Coral-Symbol sowie einen Befehl an, den Sie dem Symbol zuordnen möchten.

Unten finden Sie einen Beispielausschnitt zur Zuordnung des Befehls „Bold“ (Fett) zum Coral-Symbol mit dem Namen textItalic.

<text jcr:primaryType="nt:unstructured" sling:resourceType="cq/gui/components/authoring/dialog/richtext" name="./text" useFixedInlineToolbar="{Boolean}true">
    <rtePlugins jcr:primaryType="nt:unstructured">
        <format jcr:primaryType="nt:unstructured" features="bold,italic"/>
    </rtePlugins>
    <uiSettings jcr:primaryType="nt:unstructured">
        <cui jcr:primaryType="nt:unstructured">
            <inline jcr:primaryType="nt:unstructured"
                toolbar="[format#bold,format#italic,format#underline,links#modifylink,links#unlink]">
            </inline>
            <icons jcr:primaryType="nt:unstructured">
                <bold jcr:primaryType="nt:unstructured"
                    command="format#bold"
                    icon="textItalic"/>
            </icons>
        </cui>
    </uiSettings>
</text>

Wechseln zum CoralUI 2-Rich-Text-Editor

Sie können auf einer Seite entweder die CoralUI 2-RTE-Client-Bibliothek oder die CoralUI 3-RTE-Client-Bibliothek einbeziehen. Standardmäßig enthält der Rich-Text-Editor die CoralUI 3-RTE-Client-Bibliothek. Um zum RTE von CoralUI 2 zu wechseln, führen Sie die folgenden Schritte aus.

HINWEIS

Adobe empfiehlt dies nicht als Best Practice. Ein Wechsel zum CoralUI 2-RTE sollte nur im Notfall erfolgen. Benutzerdefinierte Plug-ins für den RTE von CoralUI 2-RTE können im RTE von CoralUI 3 verwendet werden, wenn die Plug-ins nicht von internen RTE-Elementen, etwa Klassen, abhängig sind.

Wenn Sie benutzerdefinierte Plug-ins für den RTE von CoralUI3 nutzen, verwenden Sie die Bibliothek rte.coralui3.

  1. Überlagern Sie den Knoten /libs/cq/gui/components/authoring/editors/clientlibs/core unter /apps und führen Sie folgende Schritte aus:

    • Ersetzen Sie rte.coralui3 durch rte.coralui2 für die Eigenschaft „dependencies“.
    • Ersetzen Sie cq.authoring.editor.core.inlineediting.rte.coralui3 durch cq.authoring.editor.core.inlineediting.rte.coralui2 für die Eigenschaft „embed“.
    • Ersetzen Sie cq.authoring.rte.coralui3 durch cq.authoring.rte.coralui2 für die Eigenschaft „embed“.
  2. Überlagern Sie die Knoten /libs/cq/gui/components/authoring/dialog/richtext/clientlibs/rte/coralui3 und /libs/cq/gui/components/authoring/dialog/richtext/clientlibs/rte/coralui2 unter /apps.

    Entfernen Sie die Kategorie cq.authoring.dialog aus /apps/cq/gui/components/authoring/dialog/richtext/clientlibs/rte/coralui3 und fügen Sie sie zu /apps/cq/gui/components/authoring/dialog/richtext/clientlibs/rte/coralui2 hinzu.

  3. Ändern Sie alle weiteren Abhängigkeiten, die auf der Seite aufgenommen werden, von rte.coralui3 in rte.coralui2. Ändern Sie beispielsweise nach dem Überlagern des Knotens /libs/mcm/campaign/components/touch-ui/clientlibs/rte unter /apps jegliche damit verbundenen Abhängigkeiten von rte.coralui3 in rte.coralui2.

  4. Überlagern Sie den Knoten cq/ui/widgets unter /apps. Ersetzen Sie die Abhängigkeit cq.rte im Knoten /apps/cq/ui/widgets mit cq.coralui2.rte.

HINWEIS

Der RTE von CoralUI 2 verwendet Handlebars-Vorlagen für Plug-in-Dialogfelder. Daher war die CoralUI 2-RTE-Client-Bibliothek von der Handlebars-Client-Bibliothek abhängig. Der RTE von CoralUI 3 verwendet keine Handlebars-Vorlagen und weist keine zugehörige Abhängigkeit auf. Wenn Ihre benutzerdefinierten Plug-ins Handlebars-Vorlagen verwenden, fügen Sie die Handlebars-Client-Bibliothek in Ihre Webseite ein.

Weiterführende Informationen

Weitere Informationen zum Konfigurieren des RTE finden Sie in der Referenz zur AEM Widget-API.

Insbesondere, um die verfügbaren Plug-ins und zugehörigen Optionen anzuzeigen:

  • Die CQ.form.RichText-Komponente bietet ein Formularfeld zum Bearbeiten von formatierten Textinformationen (Rich-Text). Informationen zu allen für das Rich-Text-Formular verfügbaren Parametern finden Sie in den Konfigurationsoptionen.

  • Die RichText-Komponente bietet zahlreiche Funktionen mithilfe der Plug-ins, die unter CQ.form.rte.plugins.Plugin aufgeführt sind. Für jedes Plug-in gilt dabei Folgendes:

    • Weitere Informationen zu den Funktionen, die aktiviert (oder deaktiviert) werden können, finden Sie unter „Funktionen“.
    • Unter „Konfigurationsoptionen“ finden Sie alle Parameter, die für eine detaillierte Konfiguration des entsprechenden Plug-ins verfügbar sind.
  • Es sind außerdem weitere Informationen zu HTML-Regeln für Links verfügbar.

Diese können verwendet werden, um Ihren eigenen RTE zu erweitern und anzupassen. Um zum Beispiel die auf der Seite verfügbaren Anker beim Erstellen eines Links aufzulisten, können Sie eine eigene Implementierung des LinkPlugin bereitstellen.

Bekannte Einschränkungen

Für die RTE-Funktion gelten folgende Einschränkungen:

  • RTE-Funktionen werden nur in Komponenten-Dialogfeldern von AEM unterstützt. RTE wird nicht unterstützt in Assistenten oder Foundation-Formularen wie Seiteneigenschaften und Strukturvorlage auf einer Touch-optimierten Benutzeroberfläche.

  • AEM funktioniert nicht auf Hybrid-Geräten.

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

  • RTE unterstützt keine Inline-Frame- oder iFrame-Elemente zum Einbetten von Inhalten.

Best Practices und Tipps

  • Aktivieren Sie nur Plug-ins ohne Popup-Fenster für unverankerte Dialogfelder. Plug-ins ohne Popup-Fenster sind kleiner und eignen sich am besten für unverankerte Dialogfelder.
  • Aktivieren Sie die Plug-ins mit einem größeren Popup-Fenster, beispielsweise das Paste-Plug-in, nur im Vollbildschirm-Dialogfeldmodus oder im Vollbildmodus. Plug-ins mit einem größeren Popup-Fenster beanspruchen mehr Platz auf dem Bildschirm, um ein gutes Authoring-Erlebnis zu ermöglichen.
  • Wenn Sie benutzerdefinierte Plug-ins für den RTE von CoralUI3 nutzen, verwenden Sie die Bibliothek rte.coralui3.

Beheben häufiger Probleme mit dem RTE

Wie lassen sich mehrere Tabellenzellen auswählen?

Um mehrere Zellen in einer Tabelle auszuwählen, drücken Sie Ctrl oder Cmd und klicken Sie dann nacheinander auf die Tabellenzellen.

Führen Sie nun eine Aktion für die Auswahl durch. Legen Sie beispielsweise die Eigenschaften für die ausgewählten Zellen fest.

Hyperlinks geben beim Bearbeiten von Komponenten über die Schaltfläche „Konfigurieren“ verloren

Fügen Sie in einer Textkomponente einen Hyperlink hinzu, indem Sie ihn mithilfe der Schaltfläche „Konfigurieren“ bearbeiten. Sie können den Hyperlink verlieren, wenn Sie ihn erneut bearbeiten oder ihn ein zweites Mal validieren.

Als Problemumgehung können Sie in die Textkomponente klicken, wenn das Dialogfeld „Bearbeiten“ zum zweiten Mal angezeigt wird, um dann die Validierung des Links durchzuführen.

Dieses Problem wurde mit Einführung von AEM 6.3 behoben.

Im Quell-Bearbeitungsmodus hinzugefügter HTML-Inhalt geht verloren

Fügen Sie keinen HTML-Inhalt hinzu, in den XSS eingebettet sein könnte. AEM (nicht der RTE) entfernt ggf. HTML-Inhalt, um den XSS Antisamy-Regeln zu entsprechen.

Um sicherzustellen, dass das eingefügte HTML gespeichert wird, überprüfen Sie den gespeicherten Inhalt in CRXDE (im Inhaltsknoten).

Wenn das HTML nicht gespeichert wurde, muss sie vom RTE entfernt worden sein, da es nicht den RTE-Regeln entsprach.

Falls der Inhalt in CRXDE gespeichert wurde, jedoch nicht auf der Seite gerendert wird (zeigen Sie zum Überprüfen des Renderings die Vorschau der Seite an), wurde er aufgrund der XSS-Regeln von AEM entfernt.

Mehrfeld-Komponente funktioniert nicht erwartungsgemäß

Verwenden Sie ausschließlich CoralUI 3, um eine Komponente mit mehreren Feldern zu erstellen. Verwenden Sie keine Komponenten-Dialogfelder von CoralUI 2.

Überprüfen Sie außerdem, ob der Code und die Knotenstruktur für die Mehrfeld-Implementierung korrekt sind.

Für Admins verfügbare Konfigurationen stehen Autoren nicht zur Verfügung

Wenn Aktualisierungen an Benutzeroberflächenkonfigurationen für Administrator-, jedoch nicht für Autorenkonten übernommen werden, stellen Sie sicher, dass der Konfigurationsknoten nicht mit config benannt wurde. Verwenden Sie die Eigenschaft configPath.

Auf dieser Seite