RTE-Funktionen werden über eine Reihe von Plug-ins mit jeweils einer Eigenschaft „Funktionen“ bereitgestellt. Sie können die Eigenschaft „features“ so konfigurieren, dass eine oder mehrere RTE-Funktionen aktiviert oder deaktiviert werden. In diesem Artikel wird beschrieben, wie Sie die RTE-Plug-ins spezifisch konfigurieren.
Weitere Informationen zu den anderen RTE-Konfigurationen finden Sie unter Konfigurieren des Rich-Text-Editors.
Beim Arbeiten mit CRXDE Lite ist es ratsam, die Änderungen regelmäßig mit der Option Alle speichern zu speichern.
Gehen Sie wie folgt vor, um ein Plug-in zu aktivieren. Einige Schritte sind nur erforderlich, wenn Sie ein Plug-in zum ersten Mal konfigurieren, da die entsprechenden Knoten noch nicht vorhanden sind.
Standardmäßig sind die Plug-ins format
, link
, list
, justify
und control
sowie alle ihre Funktionen im RTE aktiviert.
Der entsprechende Knoten rtePlugins
wird als <rtePlugins-node>
bezeichnet, um Dopplungen in diesem Artikel zu vermeiden.
Suchen Sie mithilfe von CRXDE Lite nach der Textkomponente für Ihr Projekt.
Falls noch nicht vorhanden, erstellen Sie den übergeordneten Knoten von <rtePlugins-node>
, bevor Sie mit dem Konfigurieren von RTE-Plug-ins beginnen:
Abhängig von Ihrer Komponente sind die übergeordneten Knoten:
config: .../text/cq:editConfig/cq:inplaceEditing/config
.../text/cq:editConfig/cq:inplaceEditing/inplaceEditingTextConfig
text: .../text/dialog/items/tab1/items/text
Sie weisen den folgenden Typ auf: jcr:primaryType cq:Widget
Beide verfügen über die folgende Eigenschaft:
name
String
./text
Je nach Benutzeroberfläche, für die Sie Konfigurationen vornehmen, müssen Sie einen Knoten <rtePlugins-node>
erstellen, falls noch nicht vorhanden:
rtePlugins
nt:unstructured
Erstellen Sie darunter einen Knoten für jedes Plug-in, das Sie aktivieren möchten:
nt:unstructured
Halten Sie sich nach der Aktivierung eines Plug-ins an diese Richtlinien, um die Eigenschaft features
zu konfigurieren.
Alle Funktionen aktivieren | Bestimmte Funktionen aktivieren | Alle Funktionen deaktivieren | |
---|---|---|---|
Name | Funktionen | Funktionen | Funktionen |
Typ | Zeichenfolge | Zeichenfolge[] (mehrere Zeichenfolgen; wählen Sie den Typ „Zeichenfolge“ aus und klicken Sie in CRXDE Lite auf „Multi“) | Zeichenfolge |
Wert | * (ein Sternchen) |
Legen Sie einen oder mehrere Werte für die Eigenschaft „features“ fest. | - |
Das findreplace
-Plug-in (Suchen und Ersetzen) erfordert keine Konfiguration. Es ist vorkonfiguriert und sofort einsatzfähig.
Bei Verwendung der Funktion zum Ersetzen sollte die Zeichenfolge zum Ersetzen gleichzeitig mit der Suchzeichenfolge eingegeben werden. Sie können jedoch weiterhin auf „Suchen“ klicken, um nach der Zeichenfolge zu suchen, bevor Sie sie ersetzen. Wenn die Zeichenfolge zum Ersetzen eingegeben wird, nachdem auf „Suchen“ geklickt wurde, wird die Suche auf den Anfang des Textes zurückgesetzt.
Das Dialogfeld „Suchen und ersetzen“ wird transparent, wenn auf „Suchen“ geklickt wird, und undurchsichtig, wenn auf „Ersetzen“ geklickt wird. Dadurch kann der Autor den Text überprüfen, den der Autor ersetzen wird. Wenn der Benutzer auf „Alle ersetzen“ klickt, wird das Dialogfeld geschlossen und die Anzahl der vorgenommenen Ersetzungen angezeigt.
Bei Verwendung des RTE können Autoren Inhalte in einem der drei folgenden Modi einfügen:
Browsermodus: Fügen Sie Text mit der Standardfunktion des Browsers zum Einfügen ein. Dieses Verfahren wird nicht empfohlen, da es unerwünschte Markups verursachen kann.
Klartextmodus: Fügen Sie Inhalte aus der Zwischenablage als Text ein. Dadurch werden alle Stil- und Formatierungselemente vom kopierten Inhalt entfernt, bevor er in eine AEM-Komponente eingefügt wird.
Microsoft Word-Modus: Fügen Sie beim Kopieren aus Microsoft Word Text, einschließlich Tabellen, mitsamt Formatierung ein. Das Kopieren und Einfügen von Text aus einer anderen Quelle wie einer Web-Seite oder Microsoft Excel wird nicht unterstützt und dabei wird nur ein Teil der Formatierung beibehalten.
Sie können Ihren Autoren in der RTE-Symbolleiste nur einige, alle oder keine dieser drei Symbole zur Verfügung stellen:
Einfügen (STRG+V): Kann vorkonfiguriert werden, um einem der drei obigen Einfügemodi zu entsprechen.
Als Text einfügen: Bietet Funktionen im Klartextmodus.
Aus Word einfügen: Bietet die Funktionen des Microsoft Word-Modus.
Um die Anzeige der Symbole in RTE zu konfigurieren, führen Sie folgende Schritte aus.
/apps/<myProject>/components/text
.rtePlugins/edit
. Lesen Sie die Informationen unter Aktivieren von Plug-ins, falls noch kein Knoten vorhanden ist.features
im Knoten edit
und fügen Sie eine oder mehrere Funktionen hinzu. Speichern Sie alle Änderungen.Sie können das Verhalten des Symbols Einfügen (STRG+V) mit folgenden Schritten vorkonfigurieren. Diese Konfiguration definiert auch das Verhalten der Tastenkombination (STRG+V), mit der Autoren Inhalte einfügen können.
Die Konfiguration ermöglicht die drei folgenden Anwendungsfälle:
Fügen Sie Text mit der Standardfunktion des Browsers zum Einfügen ein. Dieses Verfahren wird nicht empfohlen, da es unerwünschte Markups verursachen kann. Konfiguriert mithilfe von browser
, wie unten gezeigt.
Fügen Sie den Inhalt aus der Zwischenablage als Text ein. Dadurch werden alle Stil- und Formatierungselemente vom kopierten Inhalt entfernt, bevor er in eine AEM-Komponente eingefügt wird. Konfiguriert mithilfe von plaintext
, wie unten gezeigt.
Fügen Sie den Text, einschließlich Tabellen, mit Formatierung beim Kopieren aus Microsoft Word ein. Das Kopieren und Einfügen von Text aus einer anderen Quelle wie einer Web-Seite oder Microsoft Excel wird nicht unterstützt und dabei wird nur ein Teil der Formatierung beibehalten. Konfiguriert mithilfe von wordhtml
, wie unten gezeigt.
Navigieren Sie in Ihrer Komponente zum Knoten <rtePlugins-node>/edit
. Erstellen Sie die Knoten, falls diese noch nicht vorhanden sind. Weitere Informationen finden Sie unter Aktivieren von Plug-ins.
Erstellen Sie im Knoten edit
eine Eigenschaft mithilfe der folgenden Details:
defaultPasteMode
String
browser
, plaintext
oder wordhtml
.Der Modus „paste-as-Microsoft-Word“ (paste-wordhtml
) kann weiter konfiguriert werden. So können Sie explizit festlegen, welche Stile beim Einfügen von Inhalten in AEM von einem anderen Programm wie beispielsweise Microsoft Word aus zulässig sind.
Sollen beim Einfügen von Inhalten in AEM zum Beispiel nur fett gedruckte Formate und Listen zulässig sein, können Sie die anderen Formate herausfiltern. Dieser Vorgang wird als konfigurierbare Filterung beim Einfügen bezeichnet, die für Folgendes verwendet werden kann:
Für Links können Sie zudem die Protokolle definieren, die automatisch akzeptiert werden.
So konfigurieren Sie, welche Formate beim Einfügen von Text in AEM von einem anderen Programm aus zulässig sind:
Navigieren Sie in Ihrer Komponente zum Knoten <rtePlugins-node>/edit
. Erstellen Sie die Knoten, falls diese noch nicht vorhanden sind. Weitere Informationen finden Sie unter Aktivieren von Plug-ins.
Erstellen Sie unter dem Knoten edit
einen Knoten, unter dem die HTML-Einfügeregeln gespeichert werden sollen:
htmlPasteRules
nt:unstructured
Erstellen Sie unter htmlPasteRules
einen Knoten, unter dem die Details der zulässigen grundlegenden Formate gespeichert werden sollen:
allowBasics
nt:unstructured
Erstellen Sie zur Steuerung der einzelnen akzeptierten Formate eine oder mehrere der folgenden Eigenschaften im Knoten allowBasics
:
bold
italic
underline
anchor
(sowohl für Links als auch für benannte Anker)image
Alle Eigenschaften weisen den Typ Boolean
auf, daher können Sie für den geeigneten Wert das Kontrollkästchen aktivieren oder deaktivieren, um die Funktion entsprechend zu aktivieren oder zu deaktivieren.
Ist der Wert nicht explizit festgelegt, wird der Standardwert „true“ verwendet und das Format akzeptiert.
Es können mithilfe einer Reihe anderer Eigenschaften oder Knoten auch andere Formate auf den Knoten htmlPasteRules
angewendet werden:
Eigenschaft | Typ | Beschreibung |
allowBlockTags | Zeichenfolge[] | Definiert die Liste der zulässigen Block-Tags. Zu den möglichen Block-Tags gehören:
|
fallbackBlockTag | Zeichenfolge | Definiert das Block-Tag, das für alle Blöcke mit einem Block-Tag verwendet wird, das nicht in „allowBlockTags“ eingeschlossen ist. „p“ sollte in den meisten Fällen ausreichen. |
table | nt:unstructured | Definiert das Verhalten beim Einfügen von Tabellen. Dieser Knoten muss über die Eigenschaft Wenn
|
list | nt:unstructured | Definiert das Verhalten beim Einfügen von Listen. Muss über die Eigenschaft Wenn
|
Beispiel einer gültigen htmlPasteRules
-Struktur:
"htmlPasteRules": {
"allowBasics": {
"italic": true,
"link": true
},
"allowBlockTags": [
"p", "h1", "h2", "h3"
],
"list": {
"allow": false,
"ignoreMode": "paragraph"
},
"table": {
"allow": true,
"ignoreMode": "paragraph"
}
}
Autoren können Stile anwenden, um das Erscheinungsbild eines Textabschnitts zu ändern. Die Stile basieren auf CSS-Klassen, die Sie in Ihrem CSS-Stylesheet vordefinieren. Stilisierter Inhalt wird in span
-Tags eingeschlossen, wobei das Attribut class
zum Verweis auf die CSS-Klasse verwendet wird. Beispiel:
<span class=monospaced>Monospaced Text Here</span>
Wenn das styles-Plug-in zum ersten Mal aktiviert wird, sind keine Standardstile verfügbar. Die Popup-Liste ist leer. Gehen Sie wie folgt vor, um Stile für Autoren bereitzustellen:
Für spätere (Neu-)Konfigurationen, beispielsweise um weitere Stile hinzuzufügen, befolgen Sie nur die Anweisungen zum Verweisen auf ein neues Stylesheet und zum Angeben zusätzlicher Stile.
Auch für Tabellen oder Tabellenzellen können Stile definiert werden. Diese Konfigurationen erfordern unterschiedliche Vorgehensweisen.
Aktivieren Sie dazu das styles-Plug-in.
Navigieren Sie in Ihrer Komponente zum Knoten <rtePlugins-node>/styles
. Erstellen Sie die Knoten, falls diese noch nicht vorhanden sind. Weitere Informationen finden Sie unter Aktivieren von Plug-ins.
Erstellen Sie die features
-Eigenschaft für den Knoten styles
:
features
String
*
(Sternchen)Speichern Sie alle Änderungen.
Sobald das styles-Plug-in aktiviert ist, wird die Dropdown-Liste „Stil“ im Dialogfeld „Bearbeiten“ angezeigt. Allerdings ist die Liste leer, da keine Stile konfiguriert sind.
Geben Sie dann die Speicherorte für die Stylesheets an, auf die Sie verweisen möchten:
Navigieren Sie zum Stammknoten der Textkomponente, beispielsweise /apps/<myProject>/components/text
.
Fügen Sie dem übergeordneten Knoten des Knotens <rtePlugins-node>
die Eigenschaft externalStyleSheets
hinzu:
externalStyleSheets
String[]
(mehrere Zeichenfolgen; klicken Sie in CRXDE auf Multi)Sie können jederzeit Verweise auf weitere Stylesheets hinzufügen.
Speichern Sie alle Änderungen.
Wenn Sie den RTE in einem Dialogfeld verwenden (klassische Benutzeroberfläche), können Sie Stylesheets festlegen, die optimal auf die Rich-Text-Bearbeitung abgestimmt sind. Aufgrund technischer Einschränkungen geht der CSS-Kontext im Editor verloren, daher sollten Sie diesen Kontext zur Verbesserung des WYSIWYG-Verhaltens emulieren.
Der Rich-Text-Editor verwendet ein Container-DOM-Element mit einer ID von CQrte
, die verwendet werden kann, um verschiedene Stile für die Anzeige und Bearbeitung bereitzustellen:
#CQ td {
// defines the style for viewing
}
#CQrte td {
// defines the style for editing
}
Navigieren Sie in der Komponentendefinition zum Knoten <rtePlugins-node>/styles
, den Sie wie unter Aktivieren der Dropdown-Auswahl „Stil“ beschrieben erstellt haben.
Erstellen Sie unter dem Knoten styles
einen neuen Knoten (ebenfalls mit dem Namen styles
), unter dem die zur Verfügung zu stellende Liste gespeichert werden soll:
styles
cq:WidgetCollection
Erstellen Sie einen neuen Knoten unter dem Knoten styles
, um einen einzelnen Stil zu repräsentieren:
nt:unstructured
Fügen Sie diesem Knoten die Eigenschaft cssName
hinzu, um auf die CSS-Klasse zu verweisen:
cssName
String
cssClass
anstatt .cssClass
)Fügen Sie demselben Knoten die Eigenschaft text
hinzu. Dadurch wird der im Auswahlfeld angezeigte Text definiert:
text
String
Speichern Sie die Änderungen.
Wiederholen Sie die obigen Schritte für jeden erforderlichen Stil.
Autoren, die AEM zum Erstellen von japanischen Sprachinhalten verwenden, können einen Stil auf Zeichen anwenden, um Zeilenumbrüche zu vermeiden, bei denen kein Umbruch erforderlich ist. Dadurch können Autoren die Sätze an der gewünschten Position umbrechen. Der Stil für diese Funktion basiert auf der CSS-Klasse, die im CSS-Stylesheet vordefiniert ist.
Für diese Funktion ist mindestens AEM 6.5 Service Pack 1 erforderlich.
Führen Sie folgende Schritte aus, um den Stil zu erstellen, den Autoren auf japanischen Text anwenden können:
Erstellen Sie einen neuen Knoten unter dem Stil-Knoten. Siehe Festlegen eines neuen Stils.
jpn-word-wrap
Fügen Sie diesem Knoten die Eigenschaft cssName
hinzu, um auf die CSS-Klasse zu verweisen. Dieser Klassenname ist ein reservierter Name für die japanische Wortumbruchfunktion.
cssName
String
jpn-word-wrap
(ohne .
voranzustellen)Fügen Sie den Text der Eigenschaft demselben Knoten hinzu. Der Wert ist der Name des Stils, den die Autoren beim Auswählen des Stils sehen.
text
String
Japanese word-wrap
Erstellen Sie ein Stylesheet und geben Sie seinen Pfad an. Siehe Speicherort des Stylesheets angeben. Fügen Sie dem Stylesheet den folgenden Inhalt hinzu. Ändern Sie die Hintergrundfarbe wie gewünscht.
.text span.jpn-word-wrap {
display:inline-block;
}
.is-edited span.jpn-word-wrap {
background-color: #ffddff;
}
Jeglicher im RTE verfasster Text wird in einem Block-Tag platziert, standardmäßig handelt es sich dabei um das Tag <p>
. Durch Aktivierung des paraformat
-Plug-ins können Sie weitere Block-Tags festlegen, die mithilfe einer Dropdown-Auswahlliste Absätzen zugewiesen werden können. Absatzformate bestimmen den Absatztyp durch Zuweisung des richtigen Block-Tags. Der Autor kann diese mithilfe der Format-Auswahl auswählen und zuweisen. Die Beispiel-Block-Tags beinhalten u. a. den Standardabsatz „<p>“ und die Kopfzeilen „<h1>“, „<h2>“ usw.
Dieses Plug-in eignet sich nicht für Inhalte mit komplexer Struktur, beispielsweise Listen und Tabellen.
Wenn ein Block-Tag, beispielsweise ein <hr>-Tag, keinem Absatz zugewiesen werden kann, handelt es sich um keinen zulässigen Anwendungsfall für ein paraformat-Plug-in.
Wenn das paraformat-Plug-in zum ersten Mal aktiviert wird, sind keine Standabsatzformate verfügbar. Die Popup-Liste ist leer. Gehen Sie wie folgt vor, um Absatzformate für Autoren bereitzustellen:
Für spätere (Neu-)Konfigurationen, beispielsweise um weitere Formate hinzuzufügen, folgen Sie nur dem entsprechenden Teil der Anweisungen.
Aktivieren Sie zunächst das paraformat-Plug-in:
Navigieren Sie in Ihrer Komponente zum Knoten <rtePlugins-node>/paraformat
. Erstellen Sie die Knoten, falls diese noch nicht vorhanden sind. Weitere Informationen finden Sie unter Aktivieren von Plug-ins.
Erstellen Sie die features
-Eigenschaft für den Knoten paraformat
:
features
String
*
(Sternchen)Wenn das Plug-in nicht weiter konfiguriert ist, werden die folgenden Standardformate aktiviert:
<p>
)<h1>
)<h2>
)<h3>
)Entfernen Sie beim Konfigurieren der Absatzformate des RTE nicht das Absatz-Tag „<p>“ als Formatierungsoption. Wenn das Tag <p>
entfernt wird, kann der Inhaltsautor die Option Absatzformate selbst dann nicht auswählen, wenn zusätzliche Formate konfiguriert sind.
Absatzformate werden wie folgt zur Auswahl bereitgestellt:
Navigieren Sie in der Komponentendefinition zum Knoten <rtePlugins-node>/paraformat
, den Sie wie unter Aktivieren der Dropdown-Auswahl „Format“ beschrieben erstellt haben.
Erstellen Sie unter dem Knoten paraformat
einen neuen Knoten, unter dem die Liste der Formate gespeichert werden soll:
formats
cq:WidgetCollection
Erstellen Sie einen neuen Knoten unter dem Knoten formats
, der die Details für ein einzelnes Format beinhaltet:
nt:unstructured
Fügen Sie diesem Knoten die Eigenschaft hinzu, um das verwendete Block-Tag zu definieren:
Name tag
Typ String
Wert: Das Block-Tag für das Format (z. B. p, h1, h2 usw.)
Es ist nicht notwendig, die abgrenzenden spitzen Klammern einzugeben.
Fügen Sie demselben Knoten eine weitere Eigenschaft hinzu, damit ein beschreibender Text in der Dropdown-Liste angezeigt wird:
description
String
Speichern Sie die Änderungen.
Wiederholen Sie die Schritte für jedes erforderliche Format.
Die Standardformate (<p>
, <h1>
, <h2>
und <h3>
) werden entfernt, wenn Sie benutzerdefinierte Formate definieren. Da <p>
das Standardformat ist, müssen Sie dieses Format neu erstellen.
Wenn in einer AEM-Standardinstallation das misctools
-Plug-in für Sonderzeichen (specialchars
) aktiviert wird, ist sofort eine Standardauswahl verfügbar, wie beispielsweise Copyright- und Markenzeichensymbole.
Sie können den RTE aber auch so konfigurieren, dass Ihre eigene Auswahl an Zeichen zur Verfügung steht, entweder indem Sie einzelne Zeichen oder eine ganze Sequenz definieren.
Durch das Hinzufügen eigener Sonderzeichen wird die Standardauswahl überschrieben. Definieren Sie diese Zeichen bei Bedarf in Ihrer eigenen Auswahl (neu).
Navigieren Sie in Ihrer Komponente zum Knoten <rtePlugins-node>/misctools
. Erstellen Sie die Knoten, falls diese noch nicht vorhanden sind. Weitere Informationen finden Sie unter Aktivieren von Plug-ins.
Erstellen Sie die features
-Eigenschaft für den Knoten misctools
:
Name features
Typ String[]
Wert specialchars
(oder String / *
, wenn alle Funktionen für dieses Plug-in verwendet werden sollen)
Erstellen Sie unter misctools
einen Knoten, um die Sonderzeichenkonfigurationen zu speichern:
specialCharsConfig
nt:unstructured
Erstellen Sie unter specialCharsConfig
einen weiteren Knoten, unter dem die Liste der Zeichen gespeichert werden soll:
chars
nt:unstructured
Fügen Sie unter chars
einen neuen Knoten hinzu, unter dem eine individuelle Zeichendefinition gespeichert werden soll:
nt:unstructured
Fügen Sie diesem Knoten die folgende Eigenschaft hinzu:
entity
String
&189;
für die Bruchzahl „ein halb“.Speichern Sie die Änderungen.
Sobald die Eigenschaft gespeichert wurde, wird das entsprechende Zeichen in CRXDE angezeigt. Siehe „half“ im unten aufgeführten Beispiel. Wiederholen Sie die obigen Schritte, um weitere Sonderzeichen für Autoren verfügbar zu machen.
Führen Sie dazu die Schritte 1 bis 3 im Abschnitt Definieren eines einzelnen Zeichens aus.
Fügen Sie unter chars
einen neuen Knoten hinzu, unter dem die Definition des Zeichenbereichs gespeichert werden soll:
nt:unstructured
Fügen Sie unter diesem Knoten (der entsprechend dem Sonderzeichenbereich benannt wurde) die folgenden beiden Eigenschaften hinzu:
Speichern Sie die Änderungen.
Wenn Sie zum Beispiel einen Bereich von 9998 bis 10000 definieren, erhalten Sie die folgenden Zeichen:
Abbildung: Definieren Sie in CRXDE einen Zeichenbereich, um ihn im RTE verfügbar zu machen.
Neben der Definition von Stilen, die auf normalen Text angewendet werden, können Sie auch Stile (einen separaten Satz) für eine ganze Tabelle oder einzelne Tabellenzellen definieren. Diese können dann im Dialogfeld „Zellen-Eigenschaften“ oder „Tabelleneigenschaften“ im Auswahlfeld „Stil“ ausgewählt werden. Diese Stile sind nur verfügbar, wenn eine Tabelle in einer Textkomponente (oder einer abgeleiteten Komponente davon) und nicht in der standardmäßigen Tabellenkomponente bearbeitet wird.
Sie können Stile für Tabellen und Tabellenzellen nur in der klassischen Benutzeroberfläche definieren.
Die Funktion zum Kopieren und Einfügen von Tabellen in oder aus der RTE-Komponente ist Browser-abhängig. Sie wird nicht standardmäßig für alle Browser unterstützt. Je nach Tabellenstruktur und Browser können die Ergebnisse unterschiedlich ausfallen. Wenn Sie beispielsweise eine Tabelle in eine RTE-Komponente in Mozilla Firefox in der klassischen und in der Touch-optimierten Benutzeroberfläche kopieren und einfügen, bleibt das Layout der Tabelle nicht erhalten.
Navigieren Sie innerhalb Ihrer Komponente zum Knoten <rtePlugins-node>/table
. Erstellen Sie die Knoten, falls diese noch nicht vorhanden sind. Weitere Informationen finden Sie unter Aktivieren von Plug-ins.
Erstellen Sie die features
-Eigenschaft für den Knoten table
:
features
String
*
Wenn Sie nicht alle Tabellen-Features aktivieren möchten, erstellen Sie die features
-Eigenschaft wie folgt:
String[]
table
– um die Bearbeitung von Tabelleneigenschaften zuzulassen, einschließlich der Stile.cellprops
– um die Bearbeitung von Zelleneigenschaften zuzulassen, einschließlich der Stile.Definieren Sie den Speicherort von CSS-Stylesheets, um auf diese zu verweisen. Lesen Sie den Abschnitt Festlegen des Speicherorts des Stylesheets, da die Vorgehensweise hier dieselbe ist wie beim Definieren von Stilen für Text. Der Speicherort wurde möglicherweise bereits beim Definieren anderer Stile definiert.
Erstellen Sie unter dem Knoten table
die folgenden neuen Knoten (nach Bedarf):
Definieren der Stile für die komplette Tabelle (verfügbar unter Tabelleneigenschaften):
tableStyles
cq:WidgetCollection
Definieren der Stile für einzelne Tabellenzellen (verfügbar unter Zellen-Eigenschaften):
cellStyles
cq:WidgetCollection
Erstellen Sie einen neuen Knoten (unter dem Knoten tableStyles
oder cellStyles
, sofern erforderlich), der einen einzelnen Stil repräsentiert:
nt:unstructured
Erstellen Sie in diesem Knoten die folgenden Eigenschaften:
Definieren des CSS-Stils, auf den verwiesen werden soll:
cssName
String
.
voranzustellen, beispielsweise cssClass
anstatt .cssClass
)Definieren eines beschreibenden Texts, der in der Dropdown-Auswahl angezeigt werden soll:
text
String
Speichern Sie alle Änderungen.
Wiederholen Sie die obigen Schritte für jeden erforderlichen Stil.
Manchmal kann es sein, dass Sie Datentabellen ohne visuellen Text in einer Spaltenkopfzeile erstellen, da Sie voraussetzen, dass sich der Zweck der Kopfzeile durch die visuelle Beziehung der Spalte mit anderen Spalten ergibt. In diesem Fall ist es erforderlich, dass Sie ausgeblendeten inneren Text innerhalb der Zelle in der Kopfzeilenzelle bereitstellen, damit Bildschirmlesehilfen und andere unterstützende Technologien Benutzern mit unterschiedlichen Bedürfnissen helfen können, den Zweck der Spalte zu verstehen.
Um die Zugänglichkeit in solchen Fällen zu verbessern, unterstützt der RTE ausgeblendete Kopfzeilenzellen. Darüber hinaus stellt er Konfigurationseinstellungen bezüglich der ausgeblendeten Kopfzeilen in Tabellen bereit. Mithilfe dieser Einstellungen können Sie CSS-Stile auf ausgeblendete Kopfzeilen im Bearbeitungs- und im Vorschaumodus anwenden. Damit Autoren ausgeblendete Kopfzeilen im Bearbeitungsmodus besser identifizieren können, fügen Sie die folgenden Parameter in Ihren Code ein:
hiddenHeaderEditingCSS
: Gibt den Namen der CSS-Klasse an, die auf die ausgeblendete Kopfzeilenzelle angewendet wird, wenn der RTE bearbeitet wird.hiddenHeaderEditingStyle
: Gibt eine Stilzeichenfolge an, die auf die ausgeblendete Kopfzeilenzelle angewendet wird, wenn der RTE bearbeitet wird.Wenn Sie sowohl die CSS- als auch die Stilzeichenfolge im Code angeben, hat die CSS-Klasse Vorrang vor der Stilzeichenfolge. Sie überschreibt möglicherweise Konfigurationsänderungen, die mittels der Stilzeichenfolge vorgenommen werden.
Um Autoren bei der Anwendung von CSS auf ausgeblendete Kopfzeilen im Vorschaumodus zu helfen, können Sie die folgenden Parameter in Ihren Code einfügen:
hiddenHeaderClassName
: Gibt den Namen der CSS-Klasse an, die im Vorschaumodus auf die ausgeblendete Kopfzeilenzelle angewendet wird.hiddenHeaderStyle
: Gibt eine Stilzeichenfolge an, die im Vorschaumodus auf die ausgeblendete Kopfzeilenzelle angewendet wirdWenn Sie sowohl die CSS- als auch die Stilzeichenfolge im Code angeben, hat die CSS-Klasse Vorrang vor der Stilzeichenfolge. Sie überschreibt möglicherweise Konfigurationsänderungen, die mittels der Stilzeichenfolge vorgenommen werden.
Wenn das spellcheck-Plug-in aktiviert wird, verwendet der RTE Wörterbücher für jede entsprechende Sprache. Diese werden dann entsprechend der Sprache der Website ausgewählt, indem entweder die language-Eigenschaft der Unterstruktur verwendet oder die Sprache aus der URL extrahiert wird. So wird beispielsweise für den /en/
-Zweig das englische und für den /de/
-Zweig das deutsche Wörterbuch für die Überprüfung verwendet.
Die Meldung Spell checking failed
wird angezeigt, wenn versucht wird, eine Sprache zu überprüfen, die nicht installiert ist. Diese Standardwörterbücher finden Sie zusammen mit den entsprechenden README-Dateien unter /libs/cq/spellchecker/dictionaries
. Diese Dateien sollten nicht geändert werden.
Eine Standardinstallation AEM die Wörterbücher für amerikanisches Englisch (en_us
) und Britisches Englisch (en_gb
). Gehen Sie wie folgt vor, um weitere Wörterbücher hinzuzufügen.
Navigieren Sie zur Seite https://extensions.openoffice.org/.
Führen Sie einen der folgenden Schritte aus, um ein Wörterbuch Ihrer Sprache zu suchen:
Laden Sie das Archiv mit den Rechtschreibdefinitionen herunter. Entpacken Sie den Inhalt des Archivs in Ihrem Dateisystem.
Nur Wörterbücher im MySpell
-Format für OpenOffice.org v2.0.1 bzw. frühere Versionen werden unterstützt. Da die Wörterbücher jetzt Archivdateien sind, ist es ratsam, eine vollständige Prüfung nach dem Herunterladen durchzuführen.
Suchen Sie nach den *.aff- und *.dic-Dateien. Der Dateiname darf nur Kleinbuchstaben aufweisen. Zum Beispiel de_de.aff
und de_de.dic
.
Laden Sie die *.aff- und die *.dic-Dateien in das Repository unter /apps/cq/spellchecker/dictionaries
.
Die RTE-Rechtschreibprüfung ist nur auf Abruf verfügbar. Sie wird nicht automatisch ausgeführt, wenn Sie beginnen, Text einzugeben. Um die Rechtschreibprüfung auszuführen, klicken Sie in der Symbolleiste auf Rechtschreibprüfung. RTE überprüft die Rechtschreibung von Wörtern und hebt die falsch geschriebenen Wörter hervor.
Wenn Sie Änderungen einbeziehen, die die Rechtschreibprüfung vorschlägt, werden die Textänderungen und falsch geschriebenen Wörter nicht mehr hervorgehoben. Tippen/klicken Sie erneut auf die Schaltfläche „Rechtschreibprüfung“, um die Rechtschreibprüfung auszuführen.
Der RTE bietet Autoren die Möglichkeit, bei Bedarf die letzten Bearbeitungsschritte rückgängig zu machen bzw. zu wiederholen. Standardmäßig werden im Verlauf 50 Schritte gespeichert. Sie können diesen Wert nach Bedarf konfigurieren.
Navigieren Sie innerhalb Ihrer Komponente zum Knoten <rtePlugins-node>/undo
. Erstellen Sie diese Knoten, falls sie nicht bereits vorhanden sind. Weitere Informationen finden Sie unter Aktivieren von Plug-ins.
Erstellen Sie im undo
-Knoten die folgende Eigenschaft:
maxUndoSteps
Long
0
, um die Funktionen „Rückgängig“/„Wiederholen“ vollständig zu deaktivieren.Speichern Sie die Änderungen.
Wenn das Tabulatorzeichen innerhalb eines beliebigen Texts gedrückt wird, wird eine vordefinierte Anzahl von Leerzeichen eingefügt. Standardmäßig werden drei geschützte Leerzeichen und ein normales Leerzeichen eingefügt.
So definieren Sie die Tabulator-Schrittweite:
Navigieren Sie in Ihrer Komponente zum Knoten <rtePlugins-node>/keys
. Erstellen Sie die Knoten, falls diese noch nicht vorhanden sind. Weitere Informationen finden Sie unter Aktivieren von Plug-ins.
Erstellen Sie im keys
-Knoten die folgende Eigenschaft:
tabSize
String
Speichern Sie die Änderungen.
Wenn die Einzugsfunktion aktiviert ist (Standardeinstellung), können Sie die Einzugsgröße definieren:
Diese Einzugsgröße wird nur auf Absätze (Blöcke) des Texts angewendet. Sie wirkt sich nicht auf den Einzug von tatsächlichen Listen aus.
Navigieren Sie innerhalb Ihrer Komponente zum Knoten <rtePlugins-node>/lists
. Erstellen Sie diese Knoten, falls sie nicht bereits vorhanden sind. Weitere Informationen finden Sie unter Aktivieren von Plug-ins.
Erstellen Sie im lists
-Knoten den identSize
-Parameter:
identSize
Long
Diese Option ist nur anwendbar, wenn der RTE in einem Dialogfeld verwendet wird (nicht bei Bearbeitung im Kontext in der klassischen Benutzeroberfläche).
Sie können die Höhe des bearbeitbaren Bereichs definieren, der innerhalb des Komponenten-Dialogfelds angezeigt wird:
Erstellen Sie im ../items/text
-Knoten in der Dialogfelddefinition für die Komponente eine neue Eigenschaft:
height
Long
Dies wirkt sich nicht auf die Höhe des Dialogfelds aus.
Speichern Sie die Änderungen.
Wenn Sie Links in AEM einfügen, können Sie Folgendes definieren:
Um zu konfigurieren, wie Links in AEM von einem anderen Programm aus hinzugefügt werden, müssen Sie HTML-Regeln definieren.
Suchen Sie mithilfe von CRXDE Lite nach der Textkomponente für Ihr Projekt.
Erstellen Sie auf derselben Ebene wie <rtePlugins-node>
einen neuen Knoten (d. h. erstellen Sie den Knoten unter dem übergeordneten Knoten von <rtePlugins-node>
):
htmlRules
nt:unstructured
Der Knoten ../items/text
hat die Eigenschaft:
xtype
String
richtext
Der Speicherort des Knotens ../items/text
kann je nach Struktur des Dialogfelds variieren. Nachfolgend sehen Sie zwei Beispiele:
/apps/myProject>/components/text/dialog/items/text
/apps/<myProject>/components/text/dialog/items/panel/items/text
Erstellen Sie unter htmlRules
einen neuen Knoten.
links
nt:unstructured
Definieren Sie unter dem links
-Knoten die benötigten Eigenschaften:
CSS-Stil für interne Links:
cssInternal
String
cssClass
anstatt .cssClass
)CSS-Stil für externe Links
cssExternal
String
cssClass
anstatt .cssClass
)Array mit gültigen Protokollen. Die unterstützten Protokolle sind http://
, https://
, file://
und mailto:
.
protocols
String[]
defaultProtocol (Eigenschaft vom Typ Zeichenfolge): Protokoll, das verwendet wird, wenn der Benutzer keines explizit festlegt
defaultProtocol
String
Definition der Art, wie das Zielattribut eines Links verarbeitet werden soll Erstellen Sie einen neuen Knoten:
targetConfig
nt:unstructured
Definieren Sie im Knoten targetConfig
die erforderlichen Eigenschaften:
Legen Sie den Zielmodus fest:
Name mode
Typ String
)
Wert(e):
auto
: bedeutet, dass ein automatisches Ziel ausgewählt wird
(festgelegt über die targetExternal
-Eigenschaft für externe Links oder die targetInternal
-Eigenschaft für interne Links).
manual
: In diesem Kontext unzulässig
blank
: In diesem Kontext unzulässig
Das Ziel für interne Links:
targetInternal
String
auto
aktiv ist)Das Ziel für externe Links:
targetExternal
String
auto
aktiv ist)Speichern Sie alle Änderungen.