Show Menu
THEMEN×

Konfigurieren des Rich-Text-Editors

Der Rich-Text-Editor (RTE) bietet Autoren eine große Bandbreite an Funktionen zum Bearbeiten von Textinhalten. Symbole, Auswahlfelder, Symbolleiste 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 Arbeitsablauf zeigt die empfohlene Reihenfolge zum Abschluss der RTE-Konfigurationsschritte in Experience Manager.
Abbildung: Sequenz der Schritte zum Konfigurieren von RTE

Grundlegendes zur Touch-optimierten und klassischen Benutzeroberfläche

Die Touch-aktivierte Benutzeroberfläche ist die Standard-Benutzeroberfläche für Experience Manager. Adobe hat eine Touch-fähige Benutzeroberfläche mit reaktionsfähigem Design für die Authoring-Umgebung eingeführt. Die Touch-fähige Benutzeroberfläche ist für Touch- und Desktop-Geräte konzipiert. Die Oberfläche unterscheidet sich erheblich von der ursprünglichen klassischen Benutzeroberfläche.
Abbildung: Rich-Text-Editor-Symbolleiste in der Touch-fähigen Benutzeroberfläche
Abbildung: Rich-Text-Editor-Symbolleiste in der klassischen Benutzeroberfläche

Verschiedene Bearbeitungsmodi

Autoren können Textinhalte in Experience Manager mit den verschiedenen Modi von Komponenten erstellen und bearbeiten. Die Symbolleistenoptionen für das Erstellen und Formatieren von Inhalten und das Benutzererlebnis von RTE-aktivierten Komponenten in verschiedenen Bearbeitungsmodi variieren je nach RTE-Konfiguration.
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-Vollbildschirm
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
Die Funktion zum Bearbeiten der Quelle ist im Inline-Bearbeitungsmodus in der Touch-fähigen Benutzeroberfläche 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 Doppeltippen/Doppelklicken) kann der Inhalt innerhalb der Seite bearbeitet werden. Dazu steht Ihnen eine kompakte Symbolleiste mit sehr grundlegenden Optionen zur Verfügung.
Abbildung: Inline-Bearbeitung mit einfacher Symbolleiste in der Touch-fähigen Benutzeroberfläche
In der klassischen Benutzeroberfläche ermöglicht ein langsamer Doppelklick auf die Komponente die Inline-Bearbeitung. Eine orangefarbene Kontur markiert dann den Inhalt. Wenn der Content Finder 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 in Ansicht im Vollbildmodus geöffnet werden, die den Seiteninhalt ausblendet und den verfügbaren Bildschirm einnimmt. Die Bearbeitung im Vollbildmodus ist quasi eine detaillierte Version der Inline-Bearbeitung, da sie die meisten Bearbeitungsmöglichkeiten bietet. It can be opened by clicking , from the compact toolbar when using the inline editing mode.
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.
Abbildung: Die detaillierte RTE-Symbolleiste beim Bearbeiten im Vollbildmodus in der Touch-fähigen Benutzeroberfläche

Bearbeitung in einem Dialogfeld

Wenn Sie auf eine Komponente doppelklicken, öffnet sich ein Dialogfeld zur Bearbeitung des Inhalts. Das Dialogfeld öffnet sich oben auf der jeweiligen Seite. In bestimmten Fällen kann dieses Dialogfeld auch als Popup-Fenster geöffnet werden. Wenn eine Textkomponente beispielsweise Teil einer Spalte in einem mehrspaltigen Seitenlayout ist und der für das Dialogfeld verfügbare Bereich kleiner ist.
Abbildung: Dialogfeldbearbeitungsmodus in der Touch-fähigen Benutzeroberfläche
Abbildung: Dialogfeld in der klassischen Benutzeroberfläche mit detaillierter Symbolleiste zur Bearbeitung

RTE-Plug-ins und die zugehörigen Funktionen

Die Funktionen werden über eine Reihe von Plug-ins zur Verfügung gestellt, jeweils mit:
  • Eine features Eigenschaft:
    • die 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 sind durch den Wert der Eigenschaft features auf einem Knoten aktiviert oder deaktiviert, der spezifisch für das entsprechende Plug-in ist.
In der folgenden Tabelle sind die aktuellen Plug-ins und Folgendes aufgeführt:
  • Plug-in-IDs mit einem Link zur API-Dokumentation. Die ID wird bei Aktivierung 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
features
Beschreibung
edit
cut copy paste-default paste-plaintext paste-wordhtml
find replace
Suchen und Ersetzen.
fette kursive Unterstreichung
image
Grundlegende Bildunterstützung (Ziehen aus der Inhaltssuche oder Inhaltssuche). Nutzungsverhalten für Autoren kann je nach verwendetem Browser variieren
Informationen zum Definieren dieses Werts finden Sie unter Registerkarten-Größe .
justifyleft justifycenter justifyright
Absatzausrichtung
modifylink unlink anchor
ordered unordered indent outdent
This plug-in controls both indentation and lists ; including nested lists.
specialchars sourceedit
Miscellaneous tools allow authors to enter special characters or edit the HTML source. Also, you can add a whole range of special characters if you want to define your own list.
Paraformat
paraformat
The default paragraph formats are Paragraph, Heading 1, Heading 2, and Heading 3 ( <p> , <h1> , <h2> , and <h3> ). Sie können weitere Absatzformate hinzufügen oder die Liste erweitern.
spellcheck
checktext
styles
styles
Unterstützung für die Formatierung mit einer CSS-Klasse. Hinzufügen Sie neue Textstile , wenn Sie Ihren eigenen Stilbereich für die Verwendung mit Text hinzufügen (oder erweitern) möchten.
subsuperscript
subscript superscript
Erweiterungen zu den grundlegenden Formaten, indem Sie Unter- und Super-Skript hinzufügen.
table
table removetable insertrow removerow insertcolumn removecolumn cellprops mergecells splitcell selectrow selectcolumns
See configure table styles , if you want to add your own styles for either entire tables or individual cells.
undo
undo redo
History size of undo and redo operations.
Das Plug-in für den Vollbildmodus wird im Dialogfeldmodus nicht unterstützt. Use of the dialogFullScreen setting to configure the toolbar for full screen mode.

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 die Touch-optimierte Benutzeroberfläche
Speicherort für die 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
Do not name the node under cq:inplaceEditing as config . On cq:inplaceEditing node, define the following properties:
  • Name : configPath
  • Typ : String
  • Wert : Pfad des Knotens, der die tatsächliche Konfiguration enthält
Benennen Sie den RTE-Konfigurationsknoten nicht mit config . Otherwise, the RTE configurations take effect for only the administrators and not for the users in the group content-author .
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 auf dem RTE-Knoten definiert ist (mit sling:resourceType= cq/gui/components/authoring/dialog/richtext ), auf True fest, damit die RTE-Symbolleiste nicht schwebend, sondern fixiert wird.
    Wenn diese Eigenschaft auf „true“ gesetzt ist, wird die Rich-Text-Bearbeitung standardmäßig bei dem 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 ersetzenden Bearbeitung

Sie können festlegen, für welchen HTML-Selektor die Beginn des Texteditors definiert werden, indem Sie die folgenden Eigenschaften konfigurieren:
  • editElementQuery - Definiert auf cq:InplaceEditingConfig , wird diese Eigenschaft verwendet, um einen Selektor des HTML-Elements anzugeben, auf dem die Inline-Bearbeitung für die Textkomponente gestartet wird. Wenn nicht angegeben, wird die Inline-Bearbeitung direkt im HTML der Textkomponente gestartet.
  • textPropertyName - Definiert auf cq:InplaceEditingConfig , wird diese Eigenschaft verwendet, um den Namen der Eigenschaft anzugeben, die auf dem Knoten "content"gespeichert wird, auf dem der HTML-Wert der Textkomponente nach der Inline-Bearbeitung beibehalten wird.
Die entsprechende Eigenschaft für den Dialogmodus ist name .

Aktivieren von RTE-Funktionen durch Aktivieren von Plug-ins

RTE-Funktionen werden über eine Reihe von Plug-ins mit jeweils einer Eigenschaft „features“ bereitgestellt. Sie können die Funktionseigenschaft konfigurieren, um die verschiedenen Funktionen jedes Plug-ins zu (de-)aktivieren.
Ausführliche Konfigurationen des RTE-Plug-ins finden Sie unter Aktivieren und Konfigurieren von RTE-Plug-ins .
Beispiel : Laden Sie diese Beispielkonfiguration herunter, die die Konfiguration von RTE veranschaulicht. In diesem Paket sind alle Funktionen aktiviert.
Die Text-Kernkomponente gestattet es Bearbeitern von Vorlagen, viele RTE-Plug-ins in einer grafischen Benutzeroberfläche als Inhaltsrichtlinien zu konfigurieren, sodass keine technische Konfiguration mehr erforderlich ist. Inhaltsrichtlinien können mit RTE-UI-Konfigurationen verwendet werden, wie in diesem Dokument beschrieben ist.
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 wollen. 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ächen-Einstellungen verwendet. Die Symbolleisten-Eigenschaft wird verwendet, um die Schaltflächen der Symbolleiste festzulegen.
For example, if the button is itself a feature (for example, Bold ), it is specified as PluginName#FeatureName (for example, links#modifylink ).
If the button is a popover (containing some features of a plug-in), it is specified as #PluginName (for example, #format ).
Separators ( | ) between a group of buttons can be specified with - .
Der Knoten „pop-up“ im Inline- oder Vollbildmodus enthält eine Liste der verwendeten Popovers. Jeder untergeordnete Knoten unter dem Knoten „popovers“ 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. Content-Richtlinien 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. Content-Richtlinien sind wiederverwendbar und können auf eine Vielzahl von Vorlagen angewendet werden.
Die verfügbaren Optionen im RTE werden von der Benutzeroberflächenkonfiguration abwärts zu den Inhaltsrichtlinien übertragen.
  • Die Benutzeroberflächen-Konfigurationseinstellungen definieren, welche Optionen für die Content-Richtlinien verfügbar sind.
  • Wenn die Benutzeroberflächenkonfiguration des RTE entfernt wurde oder ein Element nicht aktiviert wird, kann die Inhaltsrichtlinie es 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 Text-Core Component-Dokumentation 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. Create a node named icons under uiSettings/cui .
  2. Erstellen Sie Knoten für die einzelnen Symbole darunter.
  3. Geben Sie auf jeder einzelnen Symbol-Node ein Korallensymbol und einen Befehl ein, der dem Symbol zugeordnet werden soll.
Below is a sample snippet to map the command Bold to the Coral icon named 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

Auf einer Seite können Sie entweder CoralUI 2 RTE clientlib oder CoralUI 3 RTE clientlib einbeziehen. Standardmäßig beinhaltet der Rich-Text-Editor die CoralUI 3-RTE-Client-Bibliothek. Führen Sie für den Wechsel zum CoralUI 2-RTE die folgenden Schritte aus.
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 CoralUI nutzen, verwenden Sie die Bibliothek rte.coralui3 3.
  1. Überlagern Sie die Node /libs/cq/gui/components/authoring/editors/clientlibs/core unter /apps und führen Sie folgende Schritte aus:
    • Replace rte.coralui3 with rte.coralui2 for the dependencies property.
    • Replace cq.authoring.editor.core.inlineediting.rte.coralui3 with cq.authoring.editor.core.inlineediting.rte.coralui2 for the embed property.
    • Replace cq.authoring.rte.coralui3 with cq.authoring.rte.coralui2 for the embed property.
  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 darunter /apps .
    Entfernen Sie die Kategorie cq.authoring.dialog aus /apps/cq/gui/components/authoring/dialog/richtext/clientlibs/rte/coralui3 und fügen Sie sie hinzu /apps/cq/gui/components/authoring/dialog/richtext/clientlibs/rte/coralui2 .
  3. Ändern Sie alle weiteren Abhängigkeiten, die auf der Seite aufgenommen werden, von rte.coralui3 in rte.coralui2 . For example, after overlaying the node /libs/mcm/campaign/components/touch-ui/clientlibs/rte under /apps , change any dependency on it from rte.coralui3 to rte.coralui2 .
  4. Overlay the node cq/ui/widgets under /apps . Ersetzen Sie die Abhängigkeit cq.rte am Knoten /apps/cq/ui/widgets durch cq.coralui2.rte .
Der CoralUI 2-RTE verwendet Handlebars-Vorlagen für Plug-in-Dialogfelder. Deshalb bestand eine Abhängigkeit zwischen der CoralUI 2-RTE-Client-Bibliothek und der Handlebars-Client-Bibliothek. Der CoralUI 3-RTE verwendet keine Handlebars-Vorlagen, weshalb hier keine Abhängigkeiten vorliegen. Wenn Ihre benutzerspezifischen Plug-ins Handlebars-Vorlagen verwenden, nehmen Sie die Handlebars-Client-Bibliothek in Ihre Webseite auf.

Weiterführende Informationen

Weitere Informationen zum Konfigurieren des RTE finden Sie im AEM Widget API -Referenzhandbuch.
Wenn Sie vor allem die verfügbaren Plug-ins und zugehörigen Optionen sehen wollen:
  • Die CQ.form.RichText -Komponente stellt ein Formularfeld zum Bearbeiten von formatierten Textinformationen zur Verfügung (Rich Text). Informationen zu allen verfügbaren Parametern für das Rich-Text-Formular 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“.
    • Informationen zu all den Parametern, die für eine detaillierte Konfiguration des entsprechenden Plug-ins verfügbar sind, finden Sie in den Konfigurationsoptionen.
  • Weitere Informationen zu den HTML-Regeln für Links sind ebenfalls verfügbar.
Diese können verwendet werden, um Ihre eigene 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 AEM RTE-Funktion gelten folgende Einschränkungen:
  • RTE-Funktionen werden nur in Dialogfeldern zu AEM-Komponenten unterstützt. RTE wird nicht in Assistenten und nicht in Foundation-Formularen wie Seiteneigenschaften und Strukturvorlage in der Touch-optimierten Benutzeroberfläche unterstützt.
  • AEM funktioniert nicht auf Hybrid-Geräten .
  • Do not name the RTE configuration node config . Otherwise, the RTE configuration takes effect for only the administrators and not for the users in the group content-author .
  • RTE unterstützt keine Inline-Frame- oder iFrame-Elemente zum Einbetten von Inhalten.

Best practices and tips

  • Aktivieren Sie nur die Plug-Ins ohne Popup für ein schwebendes Dialogfeld. Plug-ins ohne Popup-Fenster sind kleiner und eignen sich am besten für einen schwebenden Dialog.
  • Enable the plug-ins with larger pop-up, such as the Paste plug-in, only in the full-screen dialog mode or in full-screen mode. 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 CoralUI nutzen, verwenden Sie die Bibliothek rte.coralui3 3.

Fehlerbehebung häufiger Probleme mit RTE

Wie lassen sich mehrere Tabellenzellen auswählen?
To select multiple cells in a table, press Ctrl or Cmd key and then click the table cells one-by-one.
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
Sie können in einer Textkomponente einen Hyperlink hinzufügen, indem Sie auf die Schaltfläche „Konfigurieren“ klicken. Möglicherweise geht der Hyperlink jedoch verloren, wenn Sie ihn erneut bearbeiten und zum zweiten 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 der eingefügte HTML-Inhalt gespeichert wird, überprüfen Sie den gespeicherten Inhalt in CRXDE (im Inhaltsknoten).
Falls der HTML-Inhalt nicht gespeichert wurde, hat der RTE ihn wahrscheinlich entfernt, da er nicht den RTE-Regeln entsprochen hat.
If saved in CRXDE but not rendered on the Page (to check rendering, see page's preview , it is removed by AEM XSS rules.
Mehrfeld-Komponente funktioniert nicht erwartungsgemäß
Verwenden Sie zum Erstellen einer Mehrfeld-Komponente ausschließlich CoralUI 3. Verwenden Sie keine CoralUI 2-Dialogfelder zu Komponenten.
Überprüfen Sie außerdem, ob der Code und die Knotenstruktur für die Mehrfeld-Implementierung korrekt sind.
Für Administratoren 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. Use the configPath .