Konfigurieren des Rich-Text-Editors configure-the-rich-text-editor
Der Rich-Text-Editor (RTE) bietet Autoren eine Vielzahl von 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.
Abbildung: Typischer Workflow zum Konfigurieren des Rich-Text-Editors
Grundlegendes zur Touch-optimierten und klassischen Benutzeroberfläche understand-touch-enabled-ui-and-classic-ui
Die Touch-optimierte Benutzeroberfläche ist die standardmäßige Benutzeroberfläche für AEM. Adobe eingeführt Touch-Benutzeroberfläche mit responsives Design für die Authoring-Umgebung, in Version 5.6. Die Touch-Benutzeroberfläche ist für Touch- und Desktop-Geräte entwickelt. Die Benutzeroberfläche unterscheidet sich erheblich von der klassischen Originalbenutzeroberfläche.
Abbildung: Rich-Text-Editor-Symbolleiste in der Touch-optimierten Benutzeroberfläche
Abbildung: Rich-Text-Editor-Symbolleiste in der klassischen Benutzeroberfläche
Verschiedene Bearbeitungsmodi editingmodes
Autoren können Textinhalte in AEM mithilfe der verschiedenen Komponentenmodi erstellen und bearbeiten. Die Symbolleistenoptionen für das Authoring und Formatieren von Inhalten sowie das Benutzererlebnis von RTE-aktivierten Komponenten im verschiedenen Bearbeitungsmodus variieren je nach RTE-Konfigurationen.
Inline-Bearbeitung inline-editing
Beim Öffnen (durch langsames Doppeltippen/Klicken) kann der Inhalt innerhalb der Seite bearbeitet werden. Eine kompakte Symbolleiste mit grundlegenden Optionen erscheint.
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 full-screen-editing
AEM Komponenten können in der Vollbildansicht 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. Wenn Sie sich im Inline-Bearbeitungsmodus befinden, kann sie durch Klicken auf in der kompakten Symbolleiste geöffnet werden.
Der Dialogfeld-Vollbildmodus bietet eine detaillierte RTE-Symbolleiste sowie die Optionen und Komponenten, die im Dialogfeldmodus verfügbar sind. Dies gilt nur für ein Dialogfeld, das neben anderen Komponenten einen RTE enthält.
Abbildung: Die detaillierte RTE-Symbolleiste bei der Bearbeitung im Vollbildmodus in der Touch-optimierten Benutzeroberfläche
Bearbeitung in einem Dialogfeld dialog-editing
Wenn Sie in der klassischen Benutzeroberfläche 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.
Abbildung: Dialogfeld-Bearbeitungsmodus in Touch-optimierter Benutzeroberfläche
Abbildung: Dialogfeld in der klassischen Benutzeroberfläche mit einer Symbolleiste zur Bearbeitung
Wissenswertes über RTE-Plug-ins und die zugehörigen Funktionen aboutplugins
Die Funktionen werden über eine Reihe von Plug-ins zur Verfügung gestellt, jeweils mit:
-
einer
features
-Eigenschaft:- Diese Funktion wird verwendet, um die grundlegenden Funktionen für dieses Plug-in zu aktivieren oder zu deaktivieren.
- Dies kann mithilfe eines standardisierten Verfahrens konfiguriert werden.
-
Gegebenenfalls weitere 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 aktuellen Plug-ins mit aufgeführt:
- Plug-in-IDs mit einem Link zur API-Dokumentation. Die ID wird als Knotenname verwendet, wenn Aktivieren eines Plug-ins.
- Zulässige Werte für die Eigenschaft
features
. - Eine Beschreibung der vom Plug-in bereitgestellten Funktion.
<p>
, <h1>
, <h2>
und <h3>
). Sie können Hinzufügen weiterer Absatzformate oder erweitern Sie die Liste.dialogFullScreen
.Grundlegendes zu den Konfigurationspfaden und -speicherorten understand-the-configuration-paths-and-locations
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:
cq:editConfig/cq:inplaceEditing
cq:editConfig/cq:inplaceEditing
cq:editConfig/cq:inplaceEditing
cq:dialog
dialog
cq:dialog
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
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, aufTrue
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
aufTrue
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, aufTrue
, um den RTE-Startzeitpunkt zu steuern, indem Sie das Ereignisrte-start
auslösen. -
rte-start
: Lösen Sie dieses Ereignis beicontenteditable-div
des RTE aus, wenn die RTE-Bearbeitung gestartet werden soll. Dies funktioniert nur, wenncustomStart
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 customizing-in-place-editing
Sie können festlegen, mit welchem HTML-Selektor der Text-Editor beginnt, indem Sie die folgenden Eigenschaften konfigurieren:
editElementQuery
: Wird incq: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 incq: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 enable-rte-functionalities-by-activating-plug-ins
RTE-Funktionen werden über eine Reihe von Plug-ins mit jeweils einer Eigenschaft „Funktionen“ bereitgestellt. Sie können die features -Eigenschaft so konfigurieren, dass die verschiedenen Funktionen der einzelnen Plug-ins aktiviert oder deaktiviert werden.
Detaillierte Konfigurationen der RTE-Plug-ins finden Sie unter Aktivieren und Konfigurieren der RTE-Plug-ins.
Laden Sie diese Beispielkonfiguration herunter, um zu erfahren, wie der RTE konfiguriert wird. In diesem Paket sind alle Funktionen aktiviert.
/libs/wcm/foundation/components/text
/libs/foundation/components/text
RTE-Symbolleiste konfigurieren dialogfullscreen
AEM ermöglicht es Ihnen, die Benutzeroberfläche für den RichText-Editor für die verschiedenen Bearbeitungsmodi unterschiedlich zu konfigurieren. Die Standardeinstellungen finden Sie unten. Sie können diese Standardwerte entsprechend Ihren Anforderungen überschreiben.
Für ein optimales Authoring-Erlebnis:
- Aktivieren Sie in einem unverankerten Dialogfeld nur die Plug-ins, die kein Popup-Fenster haben, da das unverankerte Dialogfeld kleiner ist.
- Aktivieren Sie im Vollbilddialogfeld alle erforderlichen Plug-ins, auch die Plug-ins mit einem größeren Popup-Fenster, wie z. B. die
Paste
-Plug-in. Verwenden Sie diedialogFullScreen
Konfiguration weiter unten beschrieben.
<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]"
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,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 Eigenschaft "toolbar"werden die Schaltflächen der Symbolleiste angegeben. 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 kann mit '-' angegeben werden.
Der Popup-Knoten im Inline- oder Vollbildmodus enthält eine Liste der verwendeten Popovers. Jeder untergeordnete Knoten unter popovers
-Knoten nach dem Plug-in benannt wird (z. B. format
). Sie verfügt über eine Eigenschaft items
enthält eine Liste der Funktionen des Plug-ins (z. B. format#bold
).
Einstellungen für die RTE-Benutzeroberfläche und Content-Richtlinien rtecontentpolicies
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 eines bearbeitbare Vorlage. 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.
Ab AEM 6.4 Service Pack 3 werden die verfügbaren Optionen im RTE von den Benutzeroberflächenkonfigurationen auf die 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 iconstoolbar
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.
-
Erstellen Sie einen Knoten namens
icons
unteruiSettings/cui
. -
Erstellen Sie Knoten für die einzelnen Symbole darunter.
-
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 switch-to-coralui-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.
rte.coralui3
.-
Ü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
durchrte.coralui2
für die Eigenschaft „dependencies“. - Ersetzen Sie
cq.authoring.editor.core.inlineediting.rte.coralui3
durchcq.authoring.editor.core.inlineediting.rte.coralui2
für die Eigenschaft „embed“. - Ersetzen Sie
cq.authoring.rte.coralui3
durchcq.authoring.rte.coralui2
für die Eigenschaft „embed“.
- Ersetzen Sie
-
Ü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. -
Ändern Sie alle weiteren Abhängigkeiten, die auf der Seite aufgenommen werden, von
rte.coralui3
inrte.coralui2
. Ändern Sie beispielsweise nach dem Überlagern des Knotens/libs/mcm/campaign/components/touch-ui/clientlibs/rte
unter/apps
jegliche damit verbundenen Abhängigkeiten vonrte.coralui3
inrte.coralui2
. -
Überlagern Sie den Knoten
cq/ui/widgets
unter/apps
. Ersetzen Sie die Abhängigkeitcq.rte
im Knoten/apps/cq/ui/widgets
mitcq.coralui2.rte
.
Weiterführende Informationen further-information
Weitere Informationen zum Konfigurieren des RTE finden Sie unter AEM Widget-API Referenz.
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 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.
-
Weitere Informationen zu HTML-Regeln für Links finden Sie ebenfalls.
Mit den oben genannten Optionen können Sie Ihren eigenen RTE erweitern und anpassen. 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 known-limitations
AEM RTE-Funktion weist die folgenden Einschränkungen auf:
-
RTE-Funktionen werden nur in AEM Komponentendialogfeldern unterstützt. RTE wird nicht in Assistenten oder Foundation-Formularen wie Seiteneigenschaften und Strukturvorlage auf der Touch-optimierten Benutzeroberfläche.
-
AEM funktioniert nicht in Hybridgeräte.
-
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 Gruppecontent-author
in Kraft. -
RTE unterstützt keine Inline-Frame- oder iFrame-Elemente zum Einbetten von Inhalten.