← Gesamte Dokumentation

Konfigurationsreferenz

Diese Seite führt die verfügbaren Konfigurationsoptionen des Editors auf. Einrichtungsmuster und Hinweise zur Verwendung finden Sie unter Konfiguration.

Scrollen Sie auf kleineren Bildschirmen horizontal, um alle Tabellenspalten zu sehen. Tastaturbenutzer können den Tabellenbereich fokussieren und die Pfeiltasten verwenden.

NameStandardBeschreibung
skindefaultDas Erscheinungsbild der Editor-Oberfläche. Der Wert wird zur Klasse des Containers (rte-skin-<value>). Das Theme enthält dark, gray, blue und rounded-corner; auch selbst gestaltete Namen funktionieren. Ohne Angabe wird die helle Standardoberfläche verwendet. Siehe skin.
toolbardefaultdefault, basic oder full. Konfiguriert die Symbolleiste auf dem Desktop automatisch mit einer Gruppe von Schaltflächen.
toolbarMobilemobileDie Symbolleisten-Konfiguration für Mobilgeräte.
maxWidthForMobile992Wenn die Bildschirmbreite (das Browserfenster) unter 992 fällt, verwendet der Editor die mobile Symbolleiste.
timeoutAddToUndo900Bei schnellem Tippen 900 ms warten, bevor ein Rückgängig-Eintrag hinzugefügt wird.
enableDragDroptrueAktiviert oder deaktiviert die Drag-and-drop-Unterstützung des Editors.
enableObjectResizingtrueLegt fest, ob Benutzer die Größe eines Objekts innerhalb von RichTextEditor ändern dürfen.
readOnlyfalseLiest oder setzt einen Wert, der bestimmt, ob RichTextEditor ein aktiver HTML-Editor oder eine schreibgeschützte Dokumentansicht ist.
focusOnLoadfalseLegt fest, ob der Editor beim Laden der Seite den Fokus erhält. Bei true erhält er den Fokus, bei false nicht.
allowScriptCodefalseLegt fest, ob alle Skriptelemente samt Inhalt aus dem HTML entfernt werden, um JavaScript-Injektion zu verhindern. Bei false (Standard) entfernt der Rich-Text-Editor alle Skriptelemente und deren Inhalt.
tagWhiteList[]Die Positivliste enthält die Tags, die im Editor verwendet werden dürfen.
tagBlackList[]Die Sperrliste enthält die Tags, die im Editor nicht verwendet werden dürfen.
maxHTMLLength0Liest oder setzt die maximal zulässige Zeichenzahl einschließlich HTML-Tags in RichTextEditor. Der Standardwert 0 bedeutet keine Begrenzung. Bei Überschreitung stellt der Editor den letzten gültigen Zustand wieder her und löst den customdialog-Hook reachmaxlength aus.
maxTextLength0Liest oder setzt die maximal zulässige Zeichenzahl ohne HTML-Tags in RichTextEditor. Der Standardwert 0 bedeutet keine Begrenzung. Bei Überschreitung stellt der Editor den letzten gültigen Zustand wieder her und löst den customdialog-Hook reachmaxlength aus.
styleWithCSSfalseBestimmt, wie Fett, Kursiv und Unterstrichen gespeichert werden. Standardmäßig werden die Tags <b>, <i>, <u> geschrieben. boldTag und italicTag ändern deren Namen; Screenreader lesen sie als Hervorhebung vor. Setzen Sie true, um stattdessen Inline-Stile (<span style="font-weight: bold">) zu speichern. Ab Core 2.6.8; zuvor hing das Ergebnis davon ab, ob das Plugin-Bundle zuerst fertig geladen war. Derselbe Inhalt konnte daher auf beide Arten gespeichert werden.
pasteStripThemeStylestrueEntfernt beim Einfügen Inline-Stile, die nur das Theme des Editors wiederholen. Browser schreiben berechnete Stile in kopiertes HTML. Innerhalb des Editors kopierter Text enthielt deshalb bisher die Theme-Werte für Abstand, Schriftgröße und Farbe, die mitgespeichert wurden. Vom Autor gesetzte, vom Theme abweichende Stile bleiben erhalten. Setzen Sie false, um alle eingefügten Stile zu behalten. Ab Core 2.6.8.
smartTypographytrueErsetzt eingegebene Zeichen durch typografische Zeichen: gerade Anführungszeichen durch geschwungene, zwei Bindestriche durch einen Gedankenstrich, drei Punkte durch ein Auslassungszeichen und (c), (r), (tm) durch ©, ®, ™. In code, pre oder kbd wird nichts geändert. Diese Funktion gehört zum Editor-Kern und ist vom autocorrect-Plugin unabhängig; autocorrectEnabled: false schaltet sie daher nicht ab. Mit false bleibt die Eingabe unverändert. Die vier folgenden Optionen steuern die Ersetzungen einzeln.
smartTypographyQuotestrueGerade doppelte und einfache Anführungszeichen werden geschwungen (“ ” ‘ ’); ein Apostroph innerhalb eines Wortes wird zu ’ (don’t).
smartTypographyDashestrueZwei Bindestriche werden zu einem Gedankenstrich (—). Ein einzelner Bindestrich bleibt unverändert.
smartTypographyEllipsistrueDrei Punkte werden zu einem Auslassungszeichen (…).
smartTypographyTrademarkstrue(c), (r) und (tm) werden zu ©, ® und ™.
sanitizerAllowIframestrueBehält <iframe>-Elemente im Inhalt, solange die Inhaltsbereinigung aktiv ist (contentSanitizer, Teil des Plugin-Bundles). Nur Frames mit http oder https als src bleiben erhalten; srcdoc, Ereignishandler und javascript:-URLs niemals. Ohne Liste sanitizerAllowedIframeHosts erhält jeder beibehaltene Frame die Sandbox allow-scripts allow-same-origin allow-presentation: Navigation auf oberster Ebene, Pop-ups, modale Dialoge und Formulare werden unterbunden. Bei Frames vom Ursprung der Seite entfällt zusätzlich allow-same-origin. Setzen Sie false, um alle Iframes zu entfernen.
sanitizerAllowedIframeHosts[]Behält nur Frames dieser Hosts und ihrer Subdomains, zum Beispiel ["www.youtube.com", "player.vimeo.com"]. Dies ist die strengere Kontrolle: Setzen Sie die Liste, sobald die erwarteten Einbettungen bekannt sind.
maxUploadFileSize0Größte Datei in Byte, die der Editor einfügt oder hochlädt. Der Standardwert 0 bedeutet keine Begrenzung. Gilt für Bild- und Dokumentdialoge, Einfügen und Drag-and-drop. Zu große Dateien werden vor dem Lesen abgelehnt; nichts wird eingebettet oder an den Upload-Handler gesendet. Die Meldung stammt aus text_uploadtoobig. Behandeln Sie den customdialog-Hook uploadtoobig für einen eigenen Dialog.
allowBase64ImagestrueOhne Upload-Handler oder file_upload_url wird ein eingefügtes Bild als Base64-data:-URL ins HTML eingebettet. Mit false wird das Einbetten verhindert: Das Bild wird mit der Meldung text_base64disabled (customdialog-Hook base64disabled) abgelehnt; dann ist ein Upload-Handler erforderlich. Ab Core 2.6.5.
base64ImageMaxSize204800Maximale Größe eines Base64-Bildes in Byte nach der Verkleinerung (200 KB). Größere Bilder werden mit text_base64toobig (customdialog-Hook base64toobig) abgelehnt. 0 bedeutet unbegrenzt und entspricht dem Verhalten vor Core 2.6.5.
base64ImageShrinktrueVerkleinert JPEG-, PNG-, WebP- und BMP-Bilder im Browser und kodiert sie vor dem Einbetten als Base64 neu. GIF und SVG werden nie neu kodiert. Setzen Sie false, um die Originalbytes einzubetten, sofern sie unter base64ImageMaxSize liegen. Ab Core 2.6.5.
base64ImageMaxDimension1600Längste Seite in Pixeln eines für die Base64-Einbettung verkleinerten Bildes. Ab Core 2.6.5.
file_upload_urlnullURL, an die der Editor eingefügte oder abgelegte Dateien per POST als multipart/form-data sendet. Verwenden Sie diese Option anstelle eines eigenen file_upload_handler. Die Antwort darf TinyMCEs {"location": "..."}, CKEditors {"url": "..."} oder {"urls": {"default": "..."}} oder READY:<url> sein. {"error": {"message": "..."}} und ERROR:<message> gelten als Fehler, ebenso jeder andere Antworttext. Sind beide gesetzt, hat file_upload_handler Vorrang.
file_upload_fieldfileName des Formularfelds, unter dem die Datei gesendet wird. Endpoints nach CKEditor-Konvention erwarten upload.
file_upload_base_pathnullWird einer vom Endpoint zurückgegebenen relativen URL vorangestellt, um Uploads über ein CDN auszuliefern.
file_upload_credentialsfalseSendet Cookies und HTTP-Authentifizierung beim Upload an einen Endpoint mit anderem Ursprung mit.
file_upload_reuse_filenamefalseSendet die Datei unter ihrem ursprünglichen Namen. Standardmäßig wird ein eindeutiger Name erzeugt, damit zwei Benutzer mit image.png einander nicht überschreiben.
file_upload_headersnullZusätzliche Request-Header für den Upload, etwa ein CSRF-Token.
automaticUploadsfalseBei true lädt der Editor im Inhalt als Base64-data:-URLs eingebettete Bilder automatisch hoch: nach setHTMLCode sowie nach dem Einfügen von HTML. Er führt uploadEmbeddedImages() aus, durch automaticUploadsDelay (300 ms) entprellt. Ohne konfigurierten file_upload_handler geschieht nichts.
automaticUploadsDelay300Wartezeit in Millisekunden vor dem automatischen Scan, damit das Einfügen mehrerer Bilder nur einen Upload-Durchlauf auslöst.
uploadRetryCount0Zusätzliche Versuche nach einem fehlgeschlagenen Upload, bevor der Fehler den Callback Ihres Handlers und den Benutzer erreicht. Jeder Versuch löst uploadretry aus. Abgebrochene Uploads oder Uploads bereits gelöschter Bilder werden nie wiederholt.
uploadRetryDelay1000Millisekunden vor dem ersten Wiederholungsversuch. Die Wartezeit verdoppelt sich bei jedem weiteren Versuch.
autoSavenullSpeichert den Inhalt während des Tippens auf Ihrem Server: { onSave: function (html) { return promise; }, interval: 2000, indicator: true, retryCount: 3, retryDelay: 5000 }. onSave ist erforderlich. Ein zurückgegebenes Promise ermöglicht die Anzeige des Speicherergebnisses. Fehlgeschlagene Speicherungen werden mit verdoppelter Wartezeit und erneut beim Wiederherstellen der Browser-Verbindung wiederholt. Die Methoden von editor.autoSave ermöglichen manuelle Steuerung.
editorResizeModebothboth, height oder none. Liest oder setzt den Modus für Größenänderungen.
toggleBordertrueLegt den ToggleBorder-Zustand fest. ToggleBorder zeigt Rahmen an, ohne im Code border = 1 oder Ähnliches setzen zu müssen.
showSelectedBlocktrueLegt fest, ob der ausgewählte Block innerhalb von RichTextEditor angezeigt wird.
showFloatTextToolBarfalseLegt fest, ob die durch config.controltoolbar_TEXT definierte FloatTextToolBar angezeigt wird.
showFloatLinkToolBarfalseLegt fest, ob die durch config.controltoolbar_A definierte FloatLinkToolBar angezeigt wird.
showFloatImageToolBbarfalseLegt fest, ob die durch config.controltoolbar_IMG definierte FloatImageToolBbar angezeigt wird.
showFloatTableToolBarfalseLegt fest, ob die durch config.controltoolbar_TD definierte FloatTableToolBar angezeigt wird.
showFloatParagraphtrueLegt fest, ob FloatParagraph auf der linken Seite angezeigt wird.
floatParagraphPosleftLinks oder rechts. Liest oder setzt die Position von FloatParagraph.
floatParagraphPosX0Eine Zahl für die horizontale Koordinate von FloatParagraph in Pixeln.
floatParagraphPosY0Eine Zahl für die vertikale Koordinate von FloatParagraph in Pixeln.
showPlusButtontrueLegt fest, ob die Plus-Schaltfläche des Editors angezeigt wird.
showTagListtrueLegt fest, ob die Tag-Auswahl in der unteren Editor-Leiste angezeigt wird.
showStatisticstrueLegt fest, ob die Inhaltsstatistik in der unteren Editor-Leiste angezeigt wird.
tabSpaces4Liest oder setzt die Anzahl der Leerzeichen, die beim Drücken der Tabulatortaste eingefügt werden.
enterKeyTagpBestimmt das Verhalten der Eingabetaste im Editor: div, p oder br.
htmlcode_forcehexformatfalseSchreibt Farben im gespeicherten HTML als #993300 statt rgb(153, 51, 0). Der Editor reicht die gewählte Farbe unverändert weiter; der Browser normalisiert sie beim Auslesen des Stils zu rgb(). Diese Option konvertiert sie daher bei der Ausgabe. Gilt für Farben in geladenem oder eingefügtem Inhalt sowie für vom Benutzer gesetzte Text- und Hintergrundfarben. rgba() bleibt unverändert, da ein sechsstelliger Hexwert keinen Alphakanal enthält.
paragraphClassparagraphDer angegebene Klassenname wird beim Erstellen eines neuen Absatzes automatisch hinzugefügt.
insertTableTag<table></table>Standardattribute beim Einfügen einer Tabelle.
insertRowTag<tr></tr>Standardattribute beim Erstellen einer Tabellenzeile.
insertCellTag<td><br/></td>Standardattribute beim Einfügen einer Zelle.
url_base/richtexteditorOrdner, aus dem der Editor seine eigenen Dateien lädt: Inhalts- und Vorschau-Stylesheets, Vorschau-Skript, Hilfeseite und die Seite „More“ der Farbauswahl. Ab Core 2.6.10 wird ohne Angabe der Ordner verwendet, aus dem rte.js geladen wurde. CDN- und Unterordner-Installationen benötigen daher keine Einstellung; zuvor war es immer /richtexteditor. Setzen Sie die Option, um diese Dateien von anderer Stelle auszuliefern.
onready(none)Ab Core 2.6.10: eine Funktion, die einmal aufgerufen wird, sobald der Editor erstellt und sein Anfangsinhalt geladen ist (Ereignis ready). Entspricht editor.attachEvent("ready", fn).
pasteMode"Auto"Verarbeitung eingefügter Inhalte: "Auto" erhält und bereinigt die Formatierung, "PasteText" fügt immer Klartext ein, "PasteWord" wendet immer die Word-Bereinigung an und "Disabled" verhindert das Einfügen. Strg+Umschalt+V fügt in allen Modi außer Disabled Klartext ein.
smartLinkPastetrueWird bei markiertem Text eine URL eingefügt, wird die Auswahl zu einem Link, statt ersetzt zu werden.
autoLinkPastetrueAb Core 2.6.10: Eine Webadresse in eingefügtem Klartext (https://… oder www.…) wird zum Link; abschließende Satzzeichen bleiben außerhalb. Gilt nicht bei Strg+Umschalt+V oder innerhalb von Links oder Code. Mit false werden Adressen als Klartext eingefügt.
linkDefaultProtocol"http://"Ab Core 2.6.10: das Protokoll, das Adressen ohne Protokoll vorangestellt wird, etwa example.com im Linkdialog oder einer eingefügten www.-Adresse. Setzen Sie "https://" für standardmäßig sichere Links.
pasteMarkdownfalseAb Core 2.6.10: Bei true wird als Klartext eingefügtes Markdown (README, Chat, KI-Antwort) in formatierten Inhalt umgewandelt: Überschriften, Fett, Kursiv, Links, Listen, Zitate und Codeblöcke. Text ohne Markdown-Merkmale, Strg+Umschalt+V und Einfügungen innerhalb von Code bleiben Klartext. Das Ergebnis wird wie jede Einfügung bereinigt.
markdownShortcutsEnabledtrueMarkdown-Blockkürzel am Anfang eines leeren Absatzes: # bis ###### für Überschriften, - / * für Aufzählungen, 1. / 1) für nummerierte Listen (eine andere Zahl als 1 setzt den Startwert), > für Zitate, [ ] für Aufgaben (mit dem Aufgaben-Plugin), ``` für Codeblöcke und --- + Eingabetaste für eine Trennlinie. Einmal Strg+Z stellt die eingegebenen Zeichen wieder her.
markdownInlineEnabledtrueAutomatische Inline-Markdown-Formatierung beim Eingeben des schließenden Begrenzers: **bold**, *italic*, `code`, ~~strike~~. Danach eingegebener Text bleibt unformatiert.
contentCssUrl%url_base%/runtime/
richtexteditor_content.css
Gibt den Pfad des Stylesheets für den bearbeitbaren Bereich an.
previewCssUrl%url_base%/runtime/
richtexteditor_preview.css
Gibt den Pfad des Stylesheets für das Vorschaufenster an.
previewScriptUrl%url_base%/runtime/
richtexteditor_preview.js
Gibt den Pfad der JavaScript-Datei für das Vorschaufenster an.
contentCssText""Liest oder setzt Inline-CSS-Text für den bearbeitbaren Bereich, zum Beispiel "body{background-color:#eee}".
previewCssText""Liest oder setzt Inline-CSS-Text für das Vorschaufenster, zum Beispiel "body{background-color:#eee}".
editorBodyCssClass""Liest oder setzt die Klasse des Bearbeitungsbereichs zum Wechseln der Stile.
editorBodyCssText""Liest oder setzt Inline-CSS-Text für den bearbeitbaren Body.
editablePaddingTop2Setzt den oberen Innenabstand des bearbeitbaren Bereichs.
editablePaddingBottom2Setzt den unteren Innenabstand des bearbeitbaren Bereichs.
editablePaddingLeft2Setzt den linken Innenabstand des bearbeitbaren Bereichs.
editablePaddingRight2Setzt den rechten Innenabstand des bearbeitbaren Bereichs.
zIndexFullPage9999Setzt den z-index des Editors im Vollbildmodus.
zIndexFloat99999Setzt den z-index der schwebenden Symbolleiste.
zIndexDialog999999Setzt den z-index des Editor-Dialogs.
zIndexDropDown9999999Setzt den z-index des Editor-Dropdown-Menüs.
fontNameDropDownMinWidth90pxSetzt die Mindestbreite des Dropdown-Menüs für Schriftarten.
fontNameDropDownMaxWidth110pxSetzt die Höchstbreite des Dropdown-Menüs für Schriftarten.
tooltipAttributerte-tooltipSetzt das Attribut für den Tooltip des Editors.
showKeyboardShortcutsInTooltipstrueZeigt das Tastenkürzel jeder Symbolleisten-Schaltfläche im Tooltip an ("Bold (Ctrl+B)", auf einem Mac ⌘). Das Kürzel erscheint nur im Tooltip: Dialogtitel und zugänglicher Name bleiben die reine Beschriftung; die Schaltfläche trägt aria-keyshortcuts.
keyboardShortcutHints{ bold: "Ctrl+B", italic: "Ctrl+I", ... }Angezeigtes Tastenkürzel pro Befehl, mit dem Befehlsnamen als Schlüssel. Ergänzen oder ersetzen Sie Einträge passend zu selbst gebundenen Kürzeln. Schreiben Sie keine Kürzel in text_*-Beschriftungen: Diese dienen auch als Dialogtitel und zugängliche Namen und werden durch Sprachpakete ersetzt.
commentMentions[]Personen, die in Kommentaren erwähnt werden können, als Array von { id, name }. Die Eingabe von @ im Kommentarformular zeigt sie an. Eine Auswahl fügt "@Name" ein und speichert die Erwähnung am Kommentar. Leer bedeutet keine Erwähnungsliste (comments-Plugin).
text_uilocaleset by each language packGebietsschema des geladenen Sprachpakets (zum Beispiel zh-Hans, de). Der Editor benennt damit über die Intl-API des Browsers die Sprachen im Sprachmenü für Textabschnitte und in der Translate-Liste von Ask AI und formatiert Datums-Chips. Ohne Sprachpaket wird Englisch verwendet.
controlSelectionClassrte-control-selectedSetzt die Klasse für die Auswahl von Editor-Steuerelementen.
controlSelectionMargin7Setzt den Außenabstand für die Auswahl von Editor-Steuerelementen.
altTextHinttrueBilder mit fehlendem oder leerem Alternativtext erhalten im Bearbeitungsbereich einen gestrichelten bernsteinfarbenen Rahmen. So sehen Autoren, wo eine Beschreibung fehlt. Nur im Editor; das gespeicherte HTML bleibt unverändert. Mit false wird der Rahmen ausgeblendet.
autoHeadingAnchorstrueGibt jeder Überschrift kurz nach einer Änderung eine aus ihrem Text abgeleitete ID ("Hello World" wird zu hello-world), damit Links und Inhaltsverzeichnis darauf verweisen können. Duplikate erhalten -2, -3. Mit false vergibt der Kern keine IDs. Ist das Plugin-Bundle geladen, hält das Dokumentgliederungs-Plugin die Überschriften-IDs dann selbst eindeutig.
autoLinkOnTypetrueEine eingegebene URL oder E-Mail-Adresse wird zum Link, sobald das folgende Leerzeichen eingegeben wird. Mit false bleiben eingegebene Adressen Klartext.
backspaceOutdenttrueDie Rücktaste ganz am Anfang eines Listeneintrags löst diesen als Absatz aus der Liste, statt ihn mit dem vorherigen Eintrag zu verbinden. Mit false wird er stattdessen verbunden.
blockDragHandlestrueBeim Überfahren eines Blocks (Absatz, Überschrift, Liste, Tabelle ...) erscheint ein Ziehgriff. Ziehen Sie daran, um den Block zu verschieben. Mit false werden die Griffe ausgeblendet.
collabEnabledtrueErlaubt dem Kollaborations-Plugin (yjscollab), editor.collab einzurichten. Bei false tut das Plugin nichts; editor.collab existiert dann nicht. Die Zusammenarbeit beginnt erst mit editor.collab.attach(...); dieser Standardwert allein öffnet keine Verbindung. Siehe Zusammenarbeit.
collabShowPresencetrueZeigt bei angehängter Kollaborationssitzung das Panel mit den anderen Personen im Dokument. Mit false wird es ausgeblendet.
collabShowRemoteCursorstrueZeigt bei angehängter Kollaborationssitzung die Cursor und Auswahlen anderer Personen über dem Text. Mit false werden sie ausgeblendet.
collabTextSyncfalseWas eine Kollaborationssitzung außer Anwesenheit und Prüfprotokoll synchronisiert (yjscollab-Plugin): false – keinen Dokumenttext; true – Momentaufnahmen des gesamten Dokuments in einem gemeinsamen Yjs-Text; "crdt" – Zusammenführung auf Zeichenebene durch die CRDT-Engine (crdt-engine.min.js), mit Rückfall auf Momentaufnahmen, wenn die Engine fehlt.
collabRequireCrdtfalseBei collabTextSync: "crdt" und fehlender CRDT-Engine wird die Textsynchronisierung abgeschaltet, statt auf Momentaufnahmen zurückzufallen (Anwesenheit und Prüfprotokoll bleiben aktiv). Die Konsole nennt den Grund.
collabTextNamerichtextbox.bodyName des gemeinsamen Yjs-Texts für die Synchronisierung per Momentaufnahme. Geben Sie jedem Editor in einem Yjs-Dokument einen eigenen Namen.
aiToolkitEnabledtrueDas AI Toolkit-Plugin. Mit false wird es deaktiviert: keine KI-Schaltflächen, Menüs oder Dialoge. Siehe AI Toolkit.
aiToolkitResolvernullDie Funktion, über die das AI Toolkit Ihren KI-Dienst aufruft (eigener Schlüssel oder Endpoint). editor.aiToolkit.setResolver(fn) setzt sie zur Laufzeit. Ohne Resolver läuft das Toolkit im Demomodus. Die AI Toolkit-Seite beschreibt Anfrage und Antwort.
aiToolkitAgentnullDie Funktion, mit der editor.aiToolkit.runAgent(prompt) mehrstufige Änderungen plant und anwendet. setAgent(fn) setzt sie zur Laufzeit. Ohne Funktion lehnt runAgent mit einer entsprechenden Meldung ab.
aiToolkitAutoToolbarButtonstrueFügt KI-Schaltflächen automatisch zu den Symbolleisten hinzu. Setzen Sie false, um KI-Befehle in Ihrer eigenen Symbolleisten-Zeichenfolge zu platzieren.
aiToolkitActions(built-in list)Aktionen im KI-Menü: ein Array von { id, section, icon, title, description }. Ersetzen Sie es durch Ihre eigene Auswahl.
aiToolkitDialogModes(built-in list)Modi im Dialog Ask AI (Proofread, Rewrite, Translate ...): ein Array von { id, title, description }.
aiToolkitChatPrompts(built-in list)Einstiegsprompts von AI Chat: ein Array von { id, label, prompt }.
aiToolkitTranslateLanguages(Spanish, French, German, Italian...)Sprachen von Translate: ein Array von { value, label }.
aiToolkitOperationHandlersHandler nach Typ für Operationen in KI-Antworten: { myType: function (operation, context) { ... } }. Geben Sie true zurück, wenn der Handler die Operation angewendet hat. editor.aiToolkit.registerOperationHandler() ergänzt zur Laufzeit einen Handler.
aiToolkitPersistenceKey(empty)Schlüssel für dieses Dokument. Ist er gesetzt, wird der KI-Prüfstatus (Vorschläge und Entscheidungen) unter RTE.AIToolkit.<key> im localStorage des Browsers gespeichert und übersteht ein Neuladen. Er identifiziert das Dokument außerdem gegenüber aiToolkitSuggestionLedgerUrl. Leer bedeutet keine Speicherung.
aiToolkitReviewLogUrl(empty)URL auf Ihrem Server, die jede KI-Prüfentscheidung als JSON-POST für ein Auditprotokoll erhält. Leer bedeutet, dass nichts gesendet wird.
aiToolkitSuggestionLedgerUrl(empty)URL auf Ihrem Server, die KI-Vorschläge und deren Status als JSON-POST erhält, damit sie geteilt oder wiederhergestellt werden können. Benötigt aiToolkitPersistenceKey. Leer bedeutet, dass nichts gesendet wird.
aiToolkitReviewSyncInterval15000Intervall der Synchronisierung des Prüfstatus mit Ihrem Server in Millisekunden (mindestens 5000).
collabLedgerMapNamereviewLedgerName der gemeinsamen Yjs-Map, die Kommentare, Vorschläge und KI-Prüfentscheidungen zwischen Teilnehmern überträgt.
onCollabStatusnullWird beim Sitzungsstart mit { attached, textSyncMode, requestedTextSync, fallbackReason, yjsBridge, peerCount } aufgerufen. So können Sie den aktiven Modus anzeigen, etwa einen Rückfall von CRDT auf Momentaufnahmen. Dasselbe Objekt liefert editor.collab.getStatus().
imageHoverQuickBartrueBeim Überfahren eines Bildes im Editor erscheint darüber eine kleine Leiste mit Bildaktionen. Mit false wird sie ausgeblendet.
imageLazyLoadtrueVom Editor eingefügte Bilder (per URL, Upload oder Ablegen) erhalten loading="lazy" und decoding="async", damit lange Dokumente nicht alle Bilder zugleich laden. Mit false werden Bilder ohne diese Attribute eingefügt.
indentUseMargintrueEinrücken und Ausrücken ändern bei Absätzen und Überschriften den Außenabstand wie in Word (margin-left bei Text von links nach rechts). Mit false wird stattdessen der Innenabstand geändert. Die Schrittweite bestimmt indentation.
inlineMathtrueErlaubt editor.applyMathMarkup(), $...$-Abschnitte in <span class="rte-math-inline" data-tex="..."> einzuschließen, die ein Formelrenderer wie KaTeX oder MathJax darstellt. Bis zum Aufruf geschieht nichts. Bei false ändert der Aufruf nichts.
placeholderShowOnlyWhenEditabletrueBlendet placeholder aus, solange der Editor schreibgeschützt ist (readOnly oder setReadOnly(true)) oder nur Kommentare erlaubt, und zeigt ihn wieder an, sobald Bearbeiten möglich ist. Mit false erscheint er auch im schreibgeschützten Editor. (Bis 2.6.11 wurde er dort weiterhin angezeigt.)
showFloatLinkUrlPreviewtrueSteht der Cursor in einem Link, beginnt die schwebende Link-Symbolleiste mit dessen Adresse. Ein Klick öffnet sie in einem neuen Tab. Mit false werden nur die Schaltflächen angezeigt.
smartPasteToasttrueNach der Bereinigung einer Einfügung aus Word oder Google Docs erscheint ein kurzer Hinweis. Mit false erfolgt die Bereinigung ohne Hinweis.
tableColumnResizetrueAn der Grenze zweier Tabellenspalten erscheint ein Größenänderungshinweis. Ziehen ändert die Spaltenbreite. Mit false wird die Größenänderung per Ziehen deaktiviert.
tableRowResizetrueAm unteren Rand einer Tabellenzeile erscheint ein Größenänderungshinweis. Ziehen ändert die Zeilenhöhe. Mit false wird die Größenänderung per Ziehen deaktiviert.
aiContextMenutrueIst das AI Toolkit geladen, öffnet ein Rechtsklick auf markierten Text (mindestens drei Zeichen) ein Menü mit KI-Aktionen für diesen Text. Mit false bleibt das Kontextmenü des Browsers erhalten.
wordExportFileName(none)Basisdateiname für editor.exportToWord() (eine Word-kompatible .doc), wenn kein Name übergeben wird. Ohne Angabe wird der Text der ersten h1-h3-Überschrift oder "document" verwendet.
wordExportFontFamilyCalibri, 'Segoe UI', Arial, sans-serifTextschrift des .doc-Exports. Eine an exportToWord() übergebene Option hat Vorrang.
wordExportFontSize11ptSchriftgröße des Fließtexts im .doc-Export.
wordExportPageSize8.5in 11inSeitengröße des .doc-Exports als CSS-@page-Größe (standardmäßig US Letter; "21cm 29.7cm" für A4). Bereits im Dokument vorhandene Seiteneinstellungen (Seitenansicht) haben Vorrang.
wordExportMargin1inSeitenränder des .doc-Exports als CSS-Länge oder Kurzschreibweise. Seiteneinstellungen des Dokuments haben Vorrang.
wordExportLandscapefalseQuerformat im .doc-Export. Seiteneinstellungen des Dokuments haben Vorrang.
docxExportFileName(none)Basisdateiname des .docx-Exports, wenn kein Name übergeben wird. Ohne Angabe: Export-, gefolgt von Datum und Uhrzeit (YYMMDD-HHMMSS, etwa Export-261026-153045.docx).
docxExportTitle(none)Titel in den Dateieigenschaften der .docx-Datei. Ohne Angabe: document.title der Seite oder "Document".
docxExportAuthorRichTextEditorAutor in den Dateieigenschaften der .docx-Datei.
pdfExportFileName(none)Basisdateiname des PDF-Exports, wenn kein Name übergeben wird. Ohne Angabe: Export-, gefolgt von Datum und Uhrzeit (YYMMDD-HHMMSS).
pdfExportTitle(none)Titel in den PDF-Metadaten. Ohne Angabe: document.title der Seite oder "Document".
pdfExportAuthor(empty)Autor in den PDF-Metadaten.
pdfExportFonthelveticaSchriftart des Vektor-PDF-Exports (pdfexport-Plugin): "helvetica", "times" oder "courier". Diese PDF-Standardschriften benötigen keine Einbettung. Sie unterstützen nur westeuropäische lateinische Zeichen; siehe pdfExportRasterFallback.
pdfExportBaseFontSize11Schriftgröße des Fließtexts im Vektor-PDF in Punkt; Überschriften werden davon abgeleitet.
pdfExportHeader(none)Zentrierter Klartext oben auf jeder Seite des Vektor-PDFs. {page} und {total} werden zu Seitenzahl und Seitenanzahl. Ohne Angabe wird gegebenenfalls der Text der Kopfzeile des Dokuments (Seitenansicht) verwendet.
pdfExportFooter(none)Zentrierter Klartext unten auf jeder Seite mit denselben Platzhaltern {page} und {total}.
pdfExportRasterFallbacktrueEnthält ein Dokument Zeichen, die das Vektor-PDF nicht kodieren kann (außerhalb des westeuropäischen lateinischen Zeichensatzes: Chinesisch, Japanisch, Koreanisch, Kyrillisch, Griechisch, Arabisch ...), verwenden exportToPdf() und Export PDF in der Symbolleiste stattdessen den Rasterexport mit html2pdf, der alle Schriften darstellt. Die Konsole weist darauf hin. editor.getPdfUnsupportedText() listet diese Zeichen auf. Mit false wird immer das Vektor-PDF geschrieben; diese Zeichen erscheinen dann als "?". Bis 2.6.11 erschienen sie immer als "?".
pdfExportUnicodeFont(none)Bytes einer TrueType-Schrift (.ttf, als ArrayBuffer oder Uint8Array) für Text, den die Standardschriften nicht darstellen können: Chinesisch, Japanisch, Koreanisch, Kyrillisch, Griechisch ... Damit bettet das Vektor-PDF die verwendeten Glyphen ein (auch bei großen CJK-Schriften nur wenige hundert KB), und der Text bleibt auswählbar und durchsuchbar. Ohne diese Option gilt pdfExportRasterFallback. editor.loadPdfFont(url) lädt eine von Ihnen bereitgestellte Schrift und setzt die Option; ohne Aufruf wird nichts geladen. CFF- (.otf) und Collection-Dateien (.ttc) werden mit einer Konsolenmeldung abgelehnt.
mentionTrigger@Zeichen zum Öffnen der Erwähnungsliste (mentions-Plugin). Die Liste funktioniert erst, wenn mentionStaticList oder mentionSource gesetzt ist.
mentionStaticListnullFeste Personenliste für den Standardauslöser: ein Array von { id, label (or name), subtitle (or email) }. Eingaben nach dem Auslöser filtern Beschriftung, Untertitel und ID ohne Beachtung der Groß-/Kleinschreibung. Ohne Eingabe werden die ersten 50 angezeigt.
mentionSourcenullFunktion für die Liste des Standardauslösers: (query, { trigger }) => ein Array von Einträgen oder ein Promise darauf. Hat Vorrang vor mentionStaticList. Für weitere Auslöser verwenden Sie mentionTriggers oder editor.mentions.register().
mentionTriggersnullWeitere Auslöser mit jeweils { trigger, source (or search), insertClass, label, renderItem, renderInsert }, etwa # für Tags. Unterstützt werden search(query, done)-Callbacks und asynchrone Funktionen. Ein Auslöser ohne source und ohne search wird mit einer Konsolenwarnung übersprungen.
mentionMaxItems8Maximale Anzahl angezeigter Ergebnisse in der Liste.
mentionDebounceMs150Erforderliche Tipp-Pause vor der nächsten Anfrage an die Quelle in Millisekunden. Direkt nach dem Auslöser (noch keine Eingabe) erfolgt die Anfrage sofort.
mentionInsertClassrte-mentionKlasse des eingefügten Erwähnungselements. Ein Auslöser kann eine eigene insertClass setzen.
slashCommandTrigger/Taste zum Öffnen des Slash-Befehlsmenüs (slash-command-Plugin), am Zeilenanfang oder nach einem Leerzeichen eingegeben, niemals in Code oder pre.
slashCommandMaxItems40Maximale Anzahl gleichzeitig angezeigter Befehle im Slash-Menü.
documentOutlineEnabledtrueDokumentgliederungs-Panel (documentoutline-Plugin): eine Liste der Überschriften zum Navigieren im Dokument. Bei false gibt es weder die Outline-Schaltfläche noch das Panel.
documentOutlineAutoOpenfalseÖffnet das Gliederungs-Panel beim Start des Editors.
documentOutlineMinLevel1Höchste aufgeführte Überschriftenebene (1 bis 6).
documentOutlineMaxLevel6Niedrigste aufgeführte Überschriftenebene (1 bis 6, nicht über documentOutlineMinLevel).
documentOutlineTitle"Outline" (translated)Titel und zugänglicher Name des Panels. Ohne Angabe wird der Text des Sprachpakets verwendet.
documentOutlineHint(translated text)Zeile unter dem Paneltitel.
documentOutlineEmptyText(translated text)Paneltext, wenn das Dokument keine Überschriften enthält.
contentMinimapEnabledtrueMinimap-Panel (contentminimap-Plugin): kleine Vorschau des gesamten Dokuments zum Klicken und Navigieren. Bei false gibt es weder die Minimap-Schaltfläche noch das Panel.
contentMinimapAutoOpenfalseÖffnet das Minimap-Panel beim Start des Editors.
contentMinimapWidth168Panelbreite in Pixeln (mindestens 148).
contentMinimapScale0.14Verkleinerungsfaktor der Dokumentvorschau (0.14 = 14 % der Größe).
contentMinimapTitle"Minimap" (translated)Titel und zugänglicher Name des Panels.
contentMinimapHint(translated text)Zeile unter dem Paneltitel.
contentMinimapEmptyText(translated text)Paneltext bei leerem Dokument.
accessibilityCheckerEnabledtruePanel zur Barrierefreiheitsprüfung (accessibilitychecker-Plugin). Listet Probleme wie übersprungene Überschriftenebenen, Bilder ohne Alternativtext und Tabellen ohne Kopfzellen mit Korrekturen auf. Bei false gibt es weder die Symbolleisten-Schaltfläche noch das Panel.
accessibilityCheckerAutoOpenfalseÖffnet das Panel zur Barrierefreiheitsprüfung beim Start des Editors.
accessibilityCheckerTitle"Accessibility" (translated)Titel und zugänglicher Name des Panels.
accessibilityCheckerHint(translated text)Zeile unter dem Paneltitel.
accessibilityCheckerEmptyText(translated text)Paneltext, wenn keine Probleme gefunden wurden.
contentAriaLabel(none)Zugänglicher Name des Bearbeitungsbereichs und Titel des Editor-Frames (a11yenhance-Plugin), gefolgt vom Escape-Hinweis, etwa "Article body Press Escape to leave the editing area.". Ohne Angabe: "Rich text editor. Editing area." aus dem Sprachpaket. Geben Sie jedem Editor auf einer Seite einen eigenen Namen.
contentLabel(none)Wird als contentAriaLabel verwendet, wenn dieser Wert nicht gesetzt ist.
a11yEditorLabel(none)Name des Bearbeitungsbereichs, wenn weder contentAriaLabel noch contentLabel gesetzt ist (keyboarda11y-Plugin). Bis 2.6.11 war diese Option bei geladenem Plugin-Bundle wirkungslos.
a11yEscapeHint"Press Escape to leave the editing area." (translated)Text hinter dem Namen des Bearbeitungsbereichs, der Tastaturbenutzern erklärt, wie sie den Editor verlassen.
contentLang(the page's lang)lang des Bearbeitungsdokuments für Rechtschreibprüfung und Screenreader-Aussprache. Ohne Angabe wird <html lang> der Host-Seite oder en verwendet.
a11yReadOnlySuffix"Read only."Screenreader-Ansage beim Wechsel in den Schreibschutz.
a11yEditableAgain"Editing enabled."Screenreader-Ansage beim Verlassen des Schreibschutzes.
a11yRovingToolbartrueDie Symbolleiste hat einen Tabstopp; Pfeiltasten wechseln zwischen Schaltflächen (ARIA-Symbolleistenmuster). Mit false erhält jede Schaltfläche einen eigenen Tabstopp.
commentHighlightBg#fff9c4Hintergrundfarbe kommentierten Texts (comments-Plugin).
commentHighlightBorder#f9a825Farbe der Linie unter kommentiertem Text.
trackChangesInsertClassrte-tc rte-tc-insertKlasse des Elements um eine vorgeschlagene Einfügung (Vorschlagsmodus). Ändern Sie sie für Ihre eigene Gestaltung.
trackChangesDeleteClassrte-tc rte-tc-deleteKlasse des Elements um eine vorgeschlagene Löschung.
onReviewDecisionDeniednullWird mit { entry, action, user } aufgerufen, wenn reviewCanDecide das Annehmen oder Ablehnen verweigert. So können Sie den Grund mitteilen.
reviewCanDecidenullFunktion (entry, action, user, editor), die entscheidet, ob dieser Benutzer einen Vorschlag annehmen oder ablehnen darf. Geben Sie false zum Verweigern zurück. Bei einer Ausnahme wird die Entscheidung verweigert.
restrictedEditingModefalseSperrt das Dokument bis auf mit data-rte-editable="true" markierte Bereiche (restricted-editing-Plugin), wie ein Word-Formular mit ausfüllbaren Feldern. editor.restrictedEditing markiert Bereiche, schaltet die Sperre um und wechselt zwischen Bereichen.
pageHeaderHtml(empty)HTML, das in der Seitenansicht oben auf jeder Seite wiederholt wird (pagination-Plugin). {page} und {total} werden zu Seitenzahl und Seitenanzahl. Eine in den Seiteneinstellungen des Dokuments gesetzte Kopfzeile hat Vorrang.
pageFooterHtml(empty)HTML, das in der Seitenansicht unten auf jeder Seite wiederholt wird, mit denselben Platzhaltern {page} und {total}.
readabilityWordsPerMinute200Lesegeschwindigkeit für die geschätzte Lesezeit (Plugin für Lesbarkeitsstatistik).
maxLength0Maximale Zeichenzahl im Dokument (Zeichenlimit-Plugin); 0 bedeutet unbegrenzt.
maxWords0Maximale Wortzahl im Dokument; 0 bedeutet unbegrenzt.
charLimitEnforcetrueVerhindert Tippen und Einfügen über maxLength / maxWords hinaus. Bei false wird nur gezählt und gemeldet (editor.isOverLimit(), Ereignis charlimit).
charLimitShowCountertrueZeigt den schwebenden Zähler an, solange ein Limit gesetzt ist.
sanitizerAllowTags[]Zusätzliche Elementnamen, die die Inhaltsbereinigung beibehält (sanitizer-Plugin): genaue Namen, Platzhalter wie "x-*" oder reguläre Ausdrücke, etwa ["custom-el", "x-*", /^ui-/]. Skripte und andere ausführbare Elemente bleiben niemals erhalten.
sanitizerAllowAttributes[]Zusätzliche Attributnamen, die die Bereinigung beibehält, in denselben Formen, etwa ["data-cms-*"]. Ereignishandler-Attribute (on*) bleiben niemals erhalten.
sanitizerAllowStyleTagsfalseBehält <style>-Blöcke im Inhalt. Standardmäßig aus: Ein Style-Block im Dokument verändert die Gestaltung der Seite, auf der es angezeigt wird.
sanitizerGuardLiveDomtrueÜberwacht auch den Bearbeitungsbereich selbst und bereinigt ihn erneut, wenn ausführbarer Inhalt auftaucht: Skripte, on*-Attribute, javascript:-URLs. Das gilt für alle Wege, nicht nur Einfügen und setHTMLCode(), etwa Kollaborationssynchronisierung, andere Seitenskripte oder Browsererweiterungen. Bei false werden nur die editorinternen Wege bereinigt. Die Bereinigung läuft im Browser; prüfen Sie Inhalte auch auf Ihrem Server.
documentImportModereplaceVerhalten beim Dateiimport (document-import-Plugin): Dokument "replace" (ersetzen) oder am Cursor "insert" (einfügen). Ersetzen ist ein Rückgängig-Schritt.
documentImportAccept.md,.markdown,.html,.htm,.txt,.doc,.docxDateitypen, die der Importdialog anbietet.
documentImportImagestrueÜbernimmt Bilder einer importierten .docx-Datei als Daten-URIs. Mit false werden sie bei bildreichen Dateien übersprungen.
documentImportResolver(none)Funktion (file) => HTML (oder ein Promise darauf), mit der Sie Dateien selbst konvertieren, etwa auf Ihrem Server. Geben Sie zur Übernahme eine Zeichenfolge zurück; bei anderen Ergebnissen oder abgelehntem Promise greift der eingebaute Leser.
dictationEnabledfalseAktiviert Diktieren (dictation-Plugin): Sprache wird über die Spracherkennung des Browsers (Web Speech API) ins Dokument geschrieben. Standardmäßig aus. In manchen Browsern wie Chrome läuft die Erkennung auf Servern des Browseranbieters; Audiodaten verlassen also das Gerät. Prüfen Sie vor der Aktivierung, ob dies zulässig ist.
dictationLang(the browser's language)Zu erkennende Sprache als BCP-47-Tag, etwa en-US. Ohne Angabe gilt navigator.language.
dictationContinuoustrueHört auch über Pausen hinweg weiter zu. Mit false wird nach einer Äußerung gestoppt.
dictationInterimResultstrueZeigt eine vorläufige Transkription an, während der Benutzer noch spricht.
dictationAutoPunctuationtrueSchreibt den ersten Buchstaben jeder diktierten Phrase groß und ergänzt einen Punkt, wenn sie kein eigenes Satzzeichen enthält.
commentsEnabledtrueDas comments-Plugin (Inline-Kommentare, Antworten, Erledigen). Mit false wird es deaktiviert.
trackChangesEnabledtrueDas track-changes-Plugin (Vorschlagsmodus, Annehmen und Ablehnen). Mit false wird es deaktiviert.
currentUsernull{ id, name, color } – die bearbeitende Person. Kommentare, Vorschläge, Versionsverlauf und Zusammenarbeit speichern sie als Autor. Setzen Sie den Wert, sobald der Benutzer bekannt ist.
mentionEnabledtrueDas mentions-Plugin. Mit false wird es deaktiviert. Erwähnungen erscheinen erst, wenn eine Quelle gesetzt ist (mentionStaticList, mentionSource oder mentionTriggers).
slashCommandEnabledtrueSlash-Befehlsmenü (slash-command-Plugin). Mit false wird es deaktiviert.
slashCommandIncludeAitrueZeigt die Aktionen des AI Toolkit im Slash-Menü an, wenn das AI Toolkit geladen ist. Mit false werden sie ausgelassen.
slashCommandsnullZusätzliche, beim Start registrierte Slash-Menü-Befehle: ein Array von { id, section, title, description, keywords, iconSvg, run } im Format von editor.slashCommands.register().
galleryEndpoint(none)URL, über die der Galeriedialog Ordner und Bilder abfragt (insertgallery-Plugin). Liefert { currentFolder, currentFolderDisplay, parentFolder, folders: [{ folder, name }], images: [{ url, name, folder, size, source, alt }] }. Ohne Angabe zeigt die Galerie nur galleryImages und sendet keine Anfrage.
nodeTypesEnabledtrueRegistry eigener Knotentypen (nodetypes-Plugin). Mit false wird sie deaktiviert.
nodeTypes(none)Beim Start zu registrierende Knotentypen im Format von editor.nodeTypes.register(): { name, match, inline, atomic, toJSON, fromJSON, toMarkdown }. Registrierte Elemente behalten ihr Markup bei der Bereinigung und erhalten eine von Ihnen gewählte Markdown-Darstellung, statt auf ihren Text zurückzufallen.
rubyAnnotationEnabledtrueRuby-Anmerkungen (rubyannotation-Plugin): Lesehilfen über ostasiatischem Text, als <ruby> mit <rt> geschrieben. Mit false werden sie deaktiviert.
rubyAnnotationParenthesestrueSchreibt <rp>-Klammern um jede Lesehilfe, damit Leser ohne Ruby-Unterstützung "base(reading)" anzeigen, statt beide Texte zusammenzuziehen.
stateInspectorEnabledtrueZustandsinspektor (stateinspector-Plugin): Entwicklerpanel mit Dokumentstruktur, Strukturproblemen und kopierbarer Momentaufnahme für Fehlerberichte. Mit false wird es deaktiviert.
stateInspectorToolbarButtonfalseFügt eine Symbolleisten-Schaltfläche zum Öffnen des Zustandsinspektors hinzu. Standardmäßig aus; öffnen Sie ihn mit editor.stateInspector.open().
stateInspectorAutoOpenfalseÖffnet den Zustandsinspektor beim Start des Editors.
stateInspectorLogLimit60Anzahl zuletzt gespeicherter Editor-Ereignisse im Inspektor (10 bis 500).
stateInspectorMaxDepth24Tiefe, bis zu der der Inspektor den Dokumentbaum durchläuft (mindestens 2).
stateInspectorTitleState inspectorTitel des Panels.
stateInspectorHint(text)Zeile unter dem Paneltitel.
stateInspectorEmptyTextNo content to inspect yet.Paneltext bei leerem Dokument.
NameStandardBeschreibung
paragraphItemsNormal,H1,H2,H3,H4,H5,H6Vordefinierte Auswahl von Absatzformaten.
fontSizeItems8,9,10,11,12,13,14,16,
18,24,36,48,60,72,96
Vordefinierte Auswahl von Schriftgrößen.
fontNameItemsArial,Arial Black,Comic Sans MS,
Courier New,Tahoma,Georgia,Helvetica,
Segoe UI,Sans-Serif,Impact,
Times New Roman,Verdana
Vordefinierte Auswahl von Schriftarten.
lineHeightItems100%,150%,200%,250%,300%,
350%,400%,450%,500%,600%
Vordefinierte Auswahl von Zeilenhöhen.
inlineStyles[["Red", "color:red", "color:red"],
["Bold", "font-weight:bold", "font-weight:bold"],
["Mark", "my-cls-mark"],
["Warning", "my-cls-warning"]]
Standard-CSS-Stile für das Dropdown-Menü für Inline-Stile.
[text,css style, display style]
paragraphStyles[["Red", "color:red"],
["Bold", "font-weight:bold"],
["Quote", "my-cls-quote"],
["Large Center", "my-cls-largecenter"]]
Standard-CSS-Stile für das Dropdown-Menü für Absatzstile.
[text,css style, display style]
imageStyles[["Border", "border:solid 1px gray"],
["Shadow", "box-shadow:0 0 8px gray"],
["Margin10", "margin:10px"],
["Padding:10", "padding:10px"]]
Standard-CSS-Stile für das Dropdown-Menü für Bildstile.
[text,css style]
linkStyles[["Margin10", "margin:10px"],
["Padding:10", "padding:10px"],
["BigText", "font-size:36px"]]
Standard-CSS-Stile für das Dropdown-Menü für Linkstile.
[text,css style]
galleryImages[]Vorgegebene Bilder für den Galeriedialog: eine URL, [url, text] oder { url, name, alt }. Standardmäßig leer (bis 2.6.11 wurden sechs Beispielbilder von richtexteditor.com bei jedem Öffnen der Galerie von unserem Server geladen). Siehe Bildergalerie.
htmlTemplates[]Vorlagen im Dialog Insert Template: [title, html] oder { title, html, description }. Standardmäßig leer (bis 2.6.11 wurden zwei Demovorlagen mit dem Namen "My Doc 1" ausgeliefert). Ohne Vorlagen zeigt der Dialog einen entsprechenden Hinweis.
characterItemsVordefinierte Auswahl von Zeichen.
foreColorItemsVordefinierte Auswahl von Textfarben.
backColorItemsVordefinierte Auswahl von Hintergrundfarben.
linkItems[]Adressvorschläge im Dialog Insert Link, etwa ["/about", "/contact"]. Standardmäßig leer (bis 2.6.11 wurden fünf Websites großer Unternehmen vorgeschlagen). Ohne Einträge wird der Vorschlagspfeil ausgeblendet.
imageItems[]Adressvorschläge im Dialog Insert Image (per URL). Standardmäßig leer; ohne Einträge wird der Pfeil ausgeblendet.

Plugin-Optionen

Die obigen Optionen konfigurieren den Editor-Kern. Alle folgenden stammen aus den mitgelieferten Plugins in richtexteditor/plugins/. Setzen Sie sie auf dieselbe Weise: im Optionsobjekt des Konstruktors oder global in RTE_DefaultConfig, bevor ein Editor erstellt wird.

Vorschau aus dem Quellcode: neuere Plugin-Optionen

Diese Optionen existieren in den aktuellen Plugin-Quelldateien, sind aber nicht in jedem veröffentlichten Bundle oder den aktuellen Demo-Dateien dieser Website enthalten. Verwenden Sie einen passenden, getesteten Plugin-Build. Eine gesetzte Option ergänzt keine fehlende Funktion in einer älteren Laufzeit.

OptionStandardBeschreibung
aiToolkitImageResolvernullBuilds mit Bilderzeugung: (prompt: string) => Promise<string>. Ihr Resolver liefert eine HTTPS-Bild-URL oder eine Bild-Daten-URL für PNG/JPEG/WebP/GIF mit höchstens 6,000,000 Zeichen. Das Plugin ruft selbst keinen Anbieter auf. Bewahren Sie Anbieter-Zugangsdaten auf Ihrem Server auf und wenden Sie vor dem Speichern erzeugter Bilder Ihre Upload- und Speicherrichtlinien an.
galleryAcceptedExtensionsnullGalerie-Builds: Ein Array wie [".jpg", ".png"] ersetzt die im Dialog Insert Gallery genannten und erlaubten Formate. Setzen Sie es passend zu Ihrem Upload-Endpoint.
commentMentions[]Builds mit Kommentarerwähnungen: [{ id, name }] liefert die nach @ im Kommentarformular vorgeschlagenen Personen. ID und Name der gewählten Person werden am Kommentar gespeichert. Dies ist eine Vorschlagsliste; Berechtigungen sowie Benachrichtigungen oder E-Mails muss Ihre Anwendung gesondert bereitstellen.
tableRowDragtrueBuilds mit Zeilenverschiebung: Setzen Sie false vor dem Erstellen des Editors, um Zeilen-Ziehgriffe auszublenden. Kopfzeilen bleiben fest. Bei verbundenen Zellen oder ungleichmäßigen Tabellen, schreibgeschütztem Inhalt, Nur-Kommentar-Inhalt und im Vorschlagsmodus werden nicht unterstützte Verschiebungen abgelehnt. Eine Zeilenverschiebung wird nicht als Vorschlag erfasst. Escape bricht das Ziehen ab.
tableColumnDragtrueBuilds mit Spaltenverschiebung: Setzen Sie false vor dem Erstellen des Editors, um Spalten-Ziehgriffe auszublenden. Verschiebt Zellen aller Zeilen gemeinsam mit der Spaltenbreite; eine Zeilennummernspalte bleibt zuerst. Bei verbundenen Zellen oder ungleichmäßigen Tabellen, schreibgeschütztem Inhalt, Nur-Kommentar-Inhalt und im Vorschlagsmodus werden nicht unterstützte Verschiebungen abgelehnt. Escape bricht das Ziehen ab.

KI

Alle KI-Oberflächen benötigen Ihren eigenen Schlüssel: Der Editor ruft eine von Ihnen bereitgestellte Funktion auf und kommuniziert nie selbst mit einem Anbieter.

OptionStandardBeschreibung
ghostTextfalseAktiviert graue Inline-Textvervollständigung. Tab übernimmt, Esc verwirft.
ghostTextResolvernullasync ({ before }) => string. Erforderlich, damit ghostText wirksam wird.
aiToolkitReviewLegacyLayouttrueVerwendet das bisherige Seitenpanel-Layout von AI Review.
aitoolkit_skip_auto_csstrueUnterbindet das automatische Einfügen des AI Toolkit-Stylesheets, wenn Sie ein eigenes ausliefern.

Tipp- und Schreibhilfen

Funktionen, die während des Tippens ausgeführt werden. Alle lassen sich einzeln abschalten.

OptionStandardBeschreibung
autocorrectEnabledtrueHauptschalter für das autocorrect-Plugin. Schaltet die intelligente Typografie des Editor-Kerns nicht ab; siehe smartTypography.
autocorrectCapitalizetrueSchreibt den ersten Buchstaben eines Satzes groß.
autocorrectSpellingtrueWendet die eingebaute Liste häufiger Rechtschreibfehler an.
autocorrectTypographytrueTypografische Anführungszeichen, Gedankenstriche und Auslassungszeichen durch das autocorrect-Plugin. Der Editor-Kern führt dieselben Ersetzungen unabhängig aus; setzen Sie smartTypography auf false, um sie zu unterbinden.
autocorrectReplacementsnullEigene Ersetzungstabelle { from: to }, mit den eingebauten Ersetzungen zusammengeführt.
emojiAutocompleteEnabledtrueGeben Sie :shortcode: ein, um ein Emoji einzufügen.
emojiShortcodes{ … }Überschreibt oder erweitert die Zuordnung von Shortcodes zu Emojis.
foldHeadingsEnabledtrueEinklappbare Überschriften im Bearbeitungsbereich.
typewriterModeEnabledfalseHält die Cursorzeile beim Tippen vertikal an einer festen Position.
typewriterAnchor0.5Position der Cursorzeile, von 0 (oben) bis 1 (unten).
focusModeEnabledfalseBlendet alle Blöcke außer dem Block mit dem Cursor ab.
dragHandleEnabledtrueZeigt den Ziehgriff für Blöcke im Randbereich an.
dragHandleKeyboardtrueErlaubt das Umordnen von Blöcken per Tastatur (Alt+Up / Alt+Down).
formattingMarkPilcrowtrueZeigt Absatzmarken bei aktivierten Formatierungszeichen an.
formattingMarkBlockstrueUmrahmt Blockgrenzen bei aktivierten Formatierungszeichen.
formattingMarkInvisiblestrueMacht Leerzeichen, Tabulatoren und geschützte Leerzeichen sichtbar.
permanentPenClass"rte-pen"Klasse für Text mit permanenter Stiftformatierung.
permanentPenStyle{ … }Inline-Stilobjekt für Text mit permanenter Stiftformatierung.
titleCaseSmallWords"a an and as at …"Wörter, die bei Change Case → Title Case kleingeschrieben bleiben.
formatPainterProperties[ … ]CSS-Eigenschaften, die das Werkzeug zum Übertragen der Formatierung kopiert.
readabilityStatstrueZeigt Statistiken zur Lesbarkeit in der Statusleiste an.
localDraftfalseSpeichert einen lokalen Entwurf, damit Inhalte ein versehentliches Neuladen überstehen.

Blöcke, Struktur und Verweise

Strukturierte Inhalte: Hinweise, Spalten, nummerierte Listen, Fußnoten, Querverweise und Inhaltsverzeichnis.

OptionStandardBeschreibung
text_inlinecode"Inline code"Symbolleisten-Beschriftung und Tooltip der Inline-Code-Schaltfläche (Befehl "inlinecode", erzeugt ein einfaches <code>-Element).
calloutTypes[ … ]Verfügbare Hinweisarten (info, warning, …).
calloutDefaultType"info"Hinweisart, die ohne Auswahl eingefügt wird.
columnsDefaultCount2Anzahl der durch den Spaltenblock erzeugten Spalten.
legalListClass"rte-legal-list"Klasse für mehrstufige juristische Listen.
legalListSeparator"."Trennzeichen zwischen Ebenennummern (1.1.1).
legalListSuffix"."Abschließendes Zeichen nach der letzten Ebene.
lineNumberStart1Erste Zeilennummer.
lineNumberInterval1Zeigt jede N-te Zeilennummer an.
lineNumberRestart"continuous""continuous" oder Neustart je Seite.
lineNumberGutter38Breite des Nummerierungsrands in Pixeln.
footnotesTitle"Footnotes"Überschrift über der Fußnotenliste.
footnotesNumbering"decimal"Markierungsstil der Fußnotennummerierung.
footnotesMarkerPrefix""Text vor jeder Fußnotenmarkierung.
footnotesMarkerSuffix""Text nach jeder Fußnotenmarkierung.
crossRefFigureLabel"Figure"Beschriftung bei Verweisen auf eine Abbildung.
crossRefTableLabel"Table"Beschriftung bei Verweisen auf eine Tabelle.
crossRefMissingText"[reference not found]"Anzeige, wenn das Ziel eines Querverweises fehlt.
tocTitle"Contents"Überschrift des erzeugten Inhaltsverzeichnisses.
tocMinLevel1Oberste enthaltene Überschriftenebene.
tocMaxLevel3Unterste enthaltene Überschriftenebene.
tocPageNumbers"auto"Zeigt Seitenzahlen im Inhaltsverzeichnis an.
mathDialogSamples[ … ]Beispielformeln im Formeldialog.
tableNumberSeries"numeric"Nummerierungsfolge für Tabellenzeilennummern.
tableNumberHeader"#"Kopftext der Zeilennummernspalte.

Seitenlayout, Export und Import

Alles, was das Dokument in eine Datei oder eine gedruckte Seite verwandelt. Der Export läuft im Browser; nichts wird hochgeladen.

OptionStandardBeschreibung
paginationEnabledfalseZeigt das Dokument als einzelne Seiten an.
pageFormat"A4"Seitengröße für Seitenaufteilung und Export.
pageOrientation"portrait""portrait" (Hochformat) oder "landscape" (Querformat).
pageMargins{ top: 1, right: 1, bottom: 1, left: 1 }Seitenränder in Zoll.
paginationShowPageNumberstrueZeigt Seitenzahlen in der Seitenansicht an.
paginationShowPageCounttrueZeigt "of N" neben den Seitenzahlen an.
docxExporttrueAktiviert den .docx-Export (im Browser erstellt, ohne Server).
wordExporttrueAktiviert den Word-kompatiblen HTML-Export.
documentImporttrueAktiviert den .docx-Import.
pdfExporttrueAktiviert den Export als Vektor-PDF mit Tags.
html2pdfScriptUrlnullPfad zu html2pdf für den Raster-PDF-Export. Ohne Angabe ist nur der Vektorexport verfügbar.
markdownExportEnabledtrueAktiviert Copy / Download as Markdown.
emailWrapWidth640Tabellenbreite für den E-Mail-HTML-Export.
emailInlineProperties[ … ]CSS-Eigenschaften, die für E-Mail-Clients als Inline-Stile an Elemente geschrieben werden.
watermarkText"DRAFT"Text des Wasserzeichens.
watermarkImagenullBild als Wasserzeichen; überschreibt das Textwasserzeichen.
watermarkMode"tile""tile" oder eine einzelne zentrierte Markierung.
watermarkOpacity0.18Deckkraft des Wasserzeichens, 0 bis 1.
watermarkAngle-30Drehung in Grad.
watermarkColor"#94a3b8"Farbe des Wasserzeichens.
watermarkFontSize48Schriftgröße des Wasserzeichens in Pixeln.
watermarkPrintfalseDruckt das Wasserzeichen mit.

Resolver ermöglichen eigene Datenquellen. Jeder ist eine einfache Funktion; Endpoint und Zugangsdaten bleiben in Ihrer Hand.

OptionStandardBeschreibung
autoEmbedEnabledtrueWandelt eine eingefügte YouTube- oder Vimeo-URL in eine responsive Einbettung um.
autoEmbedResolvernull(url) => HTTPS-Einbettungs-URL oder null zum Ablehnen. Ergänzen Sie eigene Anbieter.
bookmarkResolvernull(url) => Metadaten für Linkvorschaukarten.
bookmarkFaviconService"/favicon-proxy?domain="Favicon-Endpoint für Lesezeichenkarten. Verweisen Sie auf Ihren eigenen Proxy.
diagramResolvernullStellen Sie einen Mermaid-Renderer bereit; es wird keiner mitgeliefert.
diagramSamples[ … ]Beispieldiagramme im Einfügedialog.
drawingWidth640Zeichnungs-Plugin (drawing.js, nächste Version): Breite der Zeichenfläche in CSS-Pixeln.
drawingHeight360Zeichnungs-Plugin (nächste Version): Höhe der Zeichenfläche in CSS-Pixeln.
drawingColors[6 colours]Zeichnungs-Plugin (nächste Version): angebotene Farbfelder für Stift und Textmarker.
text_insertdrawing"Drawing"Zeichnungs-Plugin (nächste Version): Symbolleisten-Beschriftung der Schaltfläche insertdrawing.
chipResolvernull(query) => Einträge für Smart-Chips.
chipDateFormatnullFormatzeichenfolge für Datums-Chips.
mergeFields[ … ]Verfügbare Seriendruckfelder.
mergeFieldPrefix"{{"Öffnender Begrenzer.
mergeFieldSuffix"}}"Schließender Begrenzer.
mergeFieldMissing"placeholder"Darstellung bei einem Feld ohne Wert.

Sprache, Richtung und Barrierefreiheit

Der Editor enthält 67 Sprachen. Textrichtung und Verhalten zur Barrierefreiheit lassen sich zusätzlich konfigurieren.

OptionStandardBeschreibung
defaultTextDirectionnull"ltr", "rtl" oder null zum Erben.
textDirectionAutoDetectfalseErkennt die Richtung anhand des eingegebenen Texts.
textDirectionSwapAligntrueSpiegelt die Ausrichtung beim Richtungswechsel.
rtlUserInterface"auto"Spiegelt Symbolleiste und Dialoge für RTL-Gebietsschemas.
a11yEnhancetrueZugängliche Namen und Rollen für die Editor-Oberfläche.
dialogA11ytrueFokusbegrenzung und Beschriftungen innerhalb von Dialogen.
keyboardA11ytrueWechselnder tabindex auf Symbolleisten, damit die Tabulatortaste den Editor verlässt.
readAloudRate1.0Sprechgeschwindigkeit beim Vorlesen.
readAloudHighlighttrueHebt den gerade vorgelesenen Text hervor.
textPartLanguages24 languagesSprachen im Dropdown-Menü Language: [{ code, label, dir }]. WCAG 3.1.2.
textPartLanguageHighlighttrueGepunktete Unterstreichung markierter Textabschnitte beim Bearbeiten. Nur im Editor; wird nie serialisiert.

Bearbeitungsfläche und Bereiche

Erreicht Positionen ohne Knoten für einen Cursor und steuert mehrere bearbeitbare Bereiche über eine Symbolleiste.

OptionStandardBeschreibung
gapCursorKeystruePfeiltasten/Home/End verlassen eine Tabelle oder einen anderen blockierenden Block am Dokumentrand.
gapCursorClicktrueEin Klick in den leeren Raum um Inhalte fügt dort einen Absatz ein.
gapCursorHinttrueZeigt einen Einfügehinweis an einer Grenze ohne Höhe zwischen zwei Blöcken.
multiRootGroupnullInstanzen mit diesem Gruppennamen arbeiten als ein Editor mit einer einzigen sichtbaren Symbolleiste.
multiRootNamecontainer idName dieses Bereichs in der Gruppen-API (getHTML, focusRoot, …).
multiRootToolbarHostnullElement (oder dessen ID), in das die aktive Symbolleiste verschoben wird. null lässt sie an ihrem Ort.
layoutTableOutlinetrueGestrichelter Rahmen um Layouttabellen beim Bearbeiten. Eine mit role="presentation" markierte Tabelle ist absichtlich unsichtbar; nur so sehen Sie, was Sie bearbeiten. Nur im Editor.
shadowStyleAdoptiontrueKopiert die Stylesheets des Editors in den Shadow Root, der ihn enthält. Ohne dies funktioniert die Bearbeitung, der Editor erscheint dort aber völlig ungestaltet, da kein Dokument-Stylesheet eine Shadow-Grenze überschreitet. Außerhalb eines Shadow Root entsteht kein Aufwand.
shadowStyleSourcesnullZusätzliche Stylesheet-URLs, die ebenfalls über die Shadow-Grenze kopiert werden: Ihre eigenen Skin-Anpassungen. Zeichenfolge oder Array.

Stile aus Ihrem eigenen CSS

Füllt die Quick Styles-Dropdown-Menüs aus den bereits in den Stylesheets der Seite vorhandenen Klassen, statt sie erneut in die Konfiguration einzutragen.

OptionStandardBeschreibung
importStylesfalseHauptschalter. Muss ausdrücklich aktiviert werden, da die Klassenliste auf einer Seite mit Utility-CSS sehr groß ist.
importStylesSheetsnullZu lesende Stylesheets: Zeichenfolge oder RegExp zum Abgleich mit href oder eine Funktion. null = alle lesbaren.
importStylesExclude/^(rte|ck|mce|…)/Sperrliste für Klassennamen zusätzlich zum automatischen Ausschluss des Editor-CSS.
importStylesFilternull(className, selector, bucket) => false zum Überspringen oder eine Zeichenfolge für eine andere Beschriftung.
importStylesReplacefalseErsetzt konfigurierte Stile, statt neue anzuhängen.
importStylesLimit100Limit je Dropdown-Menü. Ausgelassene Einträge werden gemeldet; es wird nie still gekürzt.

Inhaltssicherheit und Prüfung

Filterung und Validierung. Diese Optionen sind für eine Sicherheitsprüfung relevant.

OptionStandardBeschreibung
contentSanitizertruePositivlistenfilter für Eingabe, Ausgabe und aktives DOM. Lassen Sie ihn eingeschaltet.
spellCheckEnabledtrueSetzt spellcheck="true" am Bearbeitungsbereich für die Rechtschreibprüfung des Browsers.
spellCheckResolvernull(text) => [{ word, offset, length, suggestions }] von einem beliebigen von Ihnen lizenzierten Dienst.
linkCheckResolvernull(urls) => Erreichbarkeitsergebnisse für die Linkprüfung.
linkCheckMixedContenttrueMarkiert http://-Links auf einer https://-Seite.
linkCheckUnsafeSchemes["javascript:", "data:", …]Als unsicher gemeldete Schemas.

Versionsverlauf

Benannte Dokumentversionen, die im Browser gespeichert und optional an Ihren Server gesendet werden.

OptionStandardBeschreibung
revisionHistoryEnabledtrueMit false wird das Plugin für den Versionsverlauf deaktiviert.
revisionHistoryKey(page path + query)Ab Core 2.6.10: Schlüssel, unter dem die Versionen DIESES Dokuments gespeichert werden. Verwenden Sie die Datensatz-ID im CMS, besonders wenn die URL das Dokument nicht identifiziert. Frühere Builds teilten eine Liste für die gesamte Website.
revisionHistoryMaxEntries50Anzahl gespeicherter Versionen; die ältesten werden zuerst entfernt.
revisionHistoryAutoSnapshotMs0Erstellt bei geändertem Inhalt automatisch alle N ms eine Version; 0 = nur auf Anforderung.
revisionHistorySnapshotBeforeRestoretrueAb Core 2.6.10: Vor dem Wiederherstellen wird der aktuelle Inhalt als Version "Before restoring …" gesichert, damit eine irrtümliche Wiederherstellung rückgängig gemacht werden kann. false = altes Verhalten, das ungespeicherte Arbeit verwirft.
revisionHistoryUrl""Sendet jede Version als JSON per POST an diese URL.
revisionHistoryRequestHeadersnullHeader für diesen POST, als Objekt oder als Funktion, die ein Objekt liefert (etwa ein Authentifizierungstoken).
onRevisionHistorySyncErrornull(detail) => Aufruf bei fehlgeschlagenem POST; die Version bleibt lokal gespeichert.