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.
| Name | Standard | Beschreibung |
|---|---|---|
| skin | default | Das 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. |
| toolbar | default | default, basic oder full. Konfiguriert die Symbolleiste auf dem Desktop automatisch mit einer Gruppe von Schaltflächen. |
| toolbarMobile | mobile | Die Symbolleisten-Konfiguration für Mobilgeräte. |
| maxWidthForMobile | 992 | Wenn die Bildschirmbreite (das Browserfenster) unter 992 fällt, verwendet der Editor die mobile Symbolleiste. |
| timeoutAddToUndo | 900 | Bei schnellem Tippen 900 ms warten, bevor ein Rückgängig-Eintrag hinzugefügt wird. |
| enableDragDrop | true | Aktiviert oder deaktiviert die Drag-and-drop-Unterstützung des Editors. |
| enableObjectResizing | true | Legt fest, ob Benutzer die Größe eines Objekts innerhalb von RichTextEditor ändern dürfen. |
| readOnly | false | Liest oder setzt einen Wert, der bestimmt, ob RichTextEditor ein aktiver HTML-Editor oder eine schreibgeschützte Dokumentansicht ist. |
| focusOnLoad | false | Legt fest, ob der Editor beim Laden der Seite den Fokus erhält. Bei true erhält er den Fokus, bei false nicht. |
| allowScriptCode | false | Legt 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. |
| maxHTMLLength | 0 | Liest 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. |
| maxTextLength | 0 | Liest 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. |
| styleWithCSS | false | Bestimmt, 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. |
| pasteStripThemeStyles | true | Entfernt 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. |
| smartTypography | true | Ersetzt 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. |
| smartTypographyQuotes | true | Gerade doppelte und einfache Anführungszeichen werden geschwungen (“ ” ‘ ’); ein Apostroph innerhalb eines Wortes wird zu ’ (don’t). |
| smartTypographyDashes | true | Zwei Bindestriche werden zu einem Gedankenstrich (—). Ein einzelner Bindestrich bleibt unverändert. |
| smartTypographyEllipsis | true | Drei Punkte werden zu einem Auslassungszeichen (…). |
| smartTypographyTrademarks | true | (c), (r) und (tm) werden zu ©, ® und ™. |
| sanitizerAllowIframes | true | Behä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. |
| maxUploadFileSize | 0 | Größ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. |
| allowBase64Images | true | Ohne 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. |
| base64ImageMaxSize | 204800 | Maximale 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. |
| base64ImageShrink | true | Verkleinert 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. |
| base64ImageMaxDimension | 1600 | Längste Seite in Pixeln eines für die Base64-Einbettung verkleinerten Bildes. Ab Core 2.6.5. |
| file_upload_url | null | URL, 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_field | file | Name des Formularfelds, unter dem die Datei gesendet wird. Endpoints nach CKEditor-Konvention erwarten upload. |
| file_upload_base_path | null | Wird einer vom Endpoint zurückgegebenen relativen URL vorangestellt, um Uploads über ein CDN auszuliefern. |
| file_upload_credentials | false | Sendet Cookies und HTTP-Authentifizierung beim Upload an einen Endpoint mit anderem Ursprung mit. |
| file_upload_reuse_filename | false | Sendet 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_headers | null | Zusätzliche Request-Header für den Upload, etwa ein CSRF-Token. |
| automaticUploads | false | Bei 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. |
| automaticUploadsDelay | 300 | Wartezeit in Millisekunden vor dem automatischen Scan, damit das Einfügen mehrerer Bilder nur einen Upload-Durchlauf auslöst. |
| uploadRetryCount | 0 | Zusä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. |
| uploadRetryDelay | 1000 | Millisekunden vor dem ersten Wiederholungsversuch. Die Wartezeit verdoppelt sich bei jedem weiteren Versuch. |
| autoSave | null | Speichert 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. |
| editorResizeMode | both | both, height oder none. Liest oder setzt den Modus für Größenänderungen. |
| toggleBorder | true | Legt den ToggleBorder-Zustand fest. ToggleBorder zeigt Rahmen an, ohne im Code border = 1 oder Ähnliches setzen zu müssen. |
| showSelectedBlock | true | Legt fest, ob der ausgewählte Block innerhalb von RichTextEditor angezeigt wird. |
| showFloatTextToolBar | false | Legt fest, ob die durch config.controltoolbar_TEXT definierte FloatTextToolBar angezeigt wird. |
| showFloatLinkToolBar | false | Legt fest, ob die durch config.controltoolbar_A definierte FloatLinkToolBar angezeigt wird. |
| showFloatImageToolBbar | false | Legt fest, ob die durch config.controltoolbar_IMG definierte FloatImageToolBbar angezeigt wird. |
| showFloatTableToolBar | false | Legt fest, ob die durch config.controltoolbar_TD definierte FloatTableToolBar angezeigt wird. |
| showFloatParagraph | true | Legt fest, ob FloatParagraph auf der linken Seite angezeigt wird. |
| floatParagraphPos | left | Links oder rechts. Liest oder setzt die Position von FloatParagraph. |
| floatParagraphPosX | 0 | Eine Zahl für die horizontale Koordinate von FloatParagraph in Pixeln. |
| floatParagraphPosY | 0 | Eine Zahl für die vertikale Koordinate von FloatParagraph in Pixeln. |
| showPlusButton | true | Legt fest, ob die Plus-Schaltfläche des Editors angezeigt wird. |
| showTagList | true | Legt fest, ob die Tag-Auswahl in der unteren Editor-Leiste angezeigt wird. |
| showStatistics | true | Legt fest, ob die Inhaltsstatistik in der unteren Editor-Leiste angezeigt wird. |
| tabSpaces | 4 | Liest oder setzt die Anzahl der Leerzeichen, die beim Drücken der Tabulatortaste eingefügt werden. |
| enterKeyTag | p | Bestimmt das Verhalten der Eingabetaste im Editor: div, p oder br. |
| htmlcode_forcehexformat | false | Schreibt 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. |
| paragraphClass | paragraph | Der 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 | /richtexteditor | Ordner, 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. |
| smartLinkPaste | true | Wird bei markiertem Text eine URL eingefügt, wird die Auswahl zu einem Link, statt ersetzt zu werden. |
| autoLinkPaste | true | Ab 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. |
| pasteMarkdown | false | Ab 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. |
| markdownShortcutsEnabled | true | Markdown-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. |
| markdownInlineEnabled | true | Automatische 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. |
| editablePaddingTop | 2 | Setzt den oberen Innenabstand des bearbeitbaren Bereichs. |
| editablePaddingBottom | 2 | Setzt den unteren Innenabstand des bearbeitbaren Bereichs. |
| editablePaddingLeft | 2 | Setzt den linken Innenabstand des bearbeitbaren Bereichs. |
| editablePaddingRight | 2 | Setzt den rechten Innenabstand des bearbeitbaren Bereichs. |
| zIndexFullPage | 9999 | Setzt den z-index des Editors im Vollbildmodus. |
| zIndexFloat | 99999 | Setzt den z-index der schwebenden Symbolleiste. |
| zIndexDialog | 999999 | Setzt den z-index des Editor-Dialogs. |
| zIndexDropDown | 9999999 | Setzt den z-index des Editor-Dropdown-Menüs. |
| fontNameDropDownMinWidth | 90px | Setzt die Mindestbreite des Dropdown-Menüs für Schriftarten. |
| fontNameDropDownMaxWidth | 110px | Setzt die Höchstbreite des Dropdown-Menüs für Schriftarten. |
| tooltipAttribute | rte-tooltip | Setzt das Attribut für den Tooltip des Editors. |
| showKeyboardShortcutsInTooltips | true | Zeigt 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_uilocale | set by each language pack | Gebietsschema 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. |
| controlSelectionClass | rte-control-selected | Setzt die Klasse für die Auswahl von Editor-Steuerelementen. |
| controlSelectionMargin | 7 | Setzt den Außenabstand für die Auswahl von Editor-Steuerelementen. |
| altTextHint | true | Bilder 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. |
| autoHeadingAnchors | true | Gibt 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. |
| autoLinkOnType | true | Eine eingegebene URL oder E-Mail-Adresse wird zum Link, sobald das folgende Leerzeichen eingegeben wird. Mit false bleiben eingegebene Adressen Klartext. |
| backspaceOutdent | true | Die 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. |
| blockDragHandles | true | Beim Überfahren eines Blocks (Absatz, Überschrift, Liste, Tabelle ...) erscheint ein Ziehgriff. Ziehen Sie daran, um den Block zu verschieben. Mit false werden die Griffe ausgeblendet. |
| collabEnabled | true | Erlaubt 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. |
| collabShowPresence | true | Zeigt bei angehängter Kollaborationssitzung das Panel mit den anderen Personen im Dokument. Mit false wird es ausgeblendet. |
| collabShowRemoteCursors | true | Zeigt bei angehängter Kollaborationssitzung die Cursor und Auswahlen anderer Personen über dem Text. Mit false werden sie ausgeblendet. |
| collabTextSync | false | Was 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. |
| collabRequireCrdt | false | Bei 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. |
| collabTextName | richtextbox.body | Name des gemeinsamen Yjs-Texts für die Synchronisierung per Momentaufnahme. Geben Sie jedem Editor in einem Yjs-Dokument einen eigenen Namen. |
| aiToolkitEnabled | true | Das AI Toolkit-Plugin. Mit false wird es deaktiviert: keine KI-Schaltflächen, Menüs oder Dialoge. Siehe AI Toolkit. |
| aiToolkitResolver | null | Die 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. |
| aiToolkitAgent | null | Die 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. |
| aiToolkitAutoToolbarButtons | true | Fü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 }. |
| aiToolkitOperationHandlers | Handler 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. |
| aiToolkitReviewSyncInterval | 15000 | Intervall der Synchronisierung des Prüfstatus mit Ihrem Server in Millisekunden (mindestens 5000). |
| collabLedgerMapName | reviewLedger | Name der gemeinsamen Yjs-Map, die Kommentare, Vorschläge und KI-Prüfentscheidungen zwischen Teilnehmern überträgt. |
| onCollabStatus | null | Wird 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(). |
| imageHoverQuickBar | true | Beim Überfahren eines Bildes im Editor erscheint darüber eine kleine Leiste mit Bildaktionen. Mit false wird sie ausgeblendet. |
| imageLazyLoad | true | Vom 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. |
| indentUseMargin | true | Einrü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. |
| inlineMath | true | Erlaubt 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. |
| placeholderShowOnlyWhenEditable | true | Blendet 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.) |
| showFloatLinkUrlPreview | true | Steht 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. |
| smartPasteToast | true | Nach der Bereinigung einer Einfügung aus Word oder Google Docs erscheint ein kurzer Hinweis. Mit false erfolgt die Bereinigung ohne Hinweis. |
| tableColumnResize | true | An der Grenze zweier Tabellenspalten erscheint ein Größenänderungshinweis. Ziehen ändert die Spaltenbreite. Mit false wird die Größenänderung per Ziehen deaktiviert. |
| tableRowResize | true | Am unteren Rand einer Tabellenzeile erscheint ein Größenänderungshinweis. Ziehen ändert die Zeilenhöhe. Mit false wird die Größenänderung per Ziehen deaktiviert. |
| aiContextMenu | true | Ist 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. |
| wordExportFontFamily | Calibri, 'Segoe UI', Arial, sans-serif | Textschrift des .doc-Exports. Eine an exportToWord() übergebene Option hat Vorrang. |
| wordExportFontSize | 11pt | Schriftgröße des Fließtexts im .doc-Export. |
| wordExportPageSize | 8.5in 11in | Seitengröß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. |
| wordExportMargin | 1in | Seitenränder des .doc-Exports als CSS-Länge oder Kurzschreibweise. Seiteneinstellungen des Dokuments haben Vorrang. |
| wordExportLandscape | false | Querformat 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". |
| docxExportAuthor | RichTextEditor | Autor 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. |
| pdfExportFont | helvetica | Schriftart 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. |
| pdfExportBaseFontSize | 11 | Schriftgröß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}. |
| pdfExportRasterFallback | true | Enthä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. |
| mentionStaticList | null | Feste 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. |
| mentionSource | null | Funktion 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(). |
| mentionTriggers | null | Weitere 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. |
| mentionMaxItems | 8 | Maximale Anzahl angezeigter Ergebnisse in der Liste. |
| mentionDebounceMs | 150 | Erforderliche Tipp-Pause vor der nächsten Anfrage an die Quelle in Millisekunden. Direkt nach dem Auslöser (noch keine Eingabe) erfolgt die Anfrage sofort. |
| mentionInsertClass | rte-mention | Klasse 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. |
| slashCommandMaxItems | 40 | Maximale Anzahl gleichzeitig angezeigter Befehle im Slash-Menü. |
| documentOutlineEnabled | true | Dokumentgliederungs-Panel (documentoutline-Plugin): eine Liste der Überschriften zum Navigieren im Dokument. Bei false gibt es weder die Outline-Schaltfläche noch das Panel. |
| documentOutlineAutoOpen | false | Öffnet das Gliederungs-Panel beim Start des Editors. |
| documentOutlineMinLevel | 1 | Höchste aufgeführte Überschriftenebene (1 bis 6). |
| documentOutlineMaxLevel | 6 | Niedrigste 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. |
| contentMinimapEnabled | true | Minimap-Panel (contentminimap-Plugin): kleine Vorschau des gesamten Dokuments zum Klicken und Navigieren. Bei false gibt es weder die Minimap-Schaltfläche noch das Panel. |
| contentMinimapAutoOpen | false | Öffnet das Minimap-Panel beim Start des Editors. |
| contentMinimapWidth | 168 | Panelbreite in Pixeln (mindestens 148). |
| contentMinimapScale | 0.14 | Verkleinerungsfaktor 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. |
| accessibilityCheckerEnabled | true | Panel 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. |
| accessibilityCheckerAutoOpen | false | Ö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. |
| a11yRovingToolbar | true | Die Symbolleiste hat einen Tabstopp; Pfeiltasten wechseln zwischen Schaltflächen (ARIA-Symbolleistenmuster). Mit false erhält jede Schaltfläche einen eigenen Tabstopp. |
| commentHighlightBg | #fff9c4 | Hintergrundfarbe kommentierten Texts (comments-Plugin). |
| commentHighlightBorder | #f9a825 | Farbe der Linie unter kommentiertem Text. |
| trackChangesInsertClass | rte-tc rte-tc-insert | Klasse des Elements um eine vorgeschlagene Einfügung (Vorschlagsmodus). Ändern Sie sie für Ihre eigene Gestaltung. |
| trackChangesDeleteClass | rte-tc rte-tc-delete | Klasse des Elements um eine vorgeschlagene Löschung. |
| onReviewDecisionDenied | null | Wird mit { entry, action, user } aufgerufen, wenn reviewCanDecide das Annehmen oder Ablehnen verweigert. So können Sie den Grund mitteilen. |
| reviewCanDecide | null | Funktion (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. |
| restrictedEditingMode | false | Sperrt 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}. |
| readabilityWordsPerMinute | 200 | Lesegeschwindigkeit für die geschätzte Lesezeit (Plugin für Lesbarkeitsstatistik). |
| maxLength | 0 | Maximale Zeichenzahl im Dokument (Zeichenlimit-Plugin); 0 bedeutet unbegrenzt. |
| maxWords | 0 | Maximale Wortzahl im Dokument; 0 bedeutet unbegrenzt. |
| charLimitEnforce | true | Verhindert Tippen und Einfügen über maxLength / maxWords hinaus. Bei false wird nur gezählt und gemeldet (editor.isOverLimit(), Ereignis charlimit). |
| charLimitShowCounter | true | Zeigt 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. |
| sanitizerAllowStyleTags | false | Behä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. |
| sanitizerGuardLiveDom | true | Ü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. |
| documentImportMode | replace | Verhalten 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,.docx | Dateitypen, die der Importdialog anbietet. |
| documentImportImages | true | Ü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. |
| dictationEnabled | false | Aktiviert 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. |
| dictationContinuous | true | Hört auch über Pausen hinweg weiter zu. Mit false wird nach einer Äußerung gestoppt. |
| dictationInterimResults | true | Zeigt eine vorläufige Transkription an, während der Benutzer noch spricht. |
| dictationAutoPunctuation | true | Schreibt den ersten Buchstaben jeder diktierten Phrase groß und ergänzt einen Punkt, wenn sie kein eigenes Satzzeichen enthält. |
| commentsEnabled | true | Das comments-Plugin (Inline-Kommentare, Antworten, Erledigen). Mit false wird es deaktiviert. |
| trackChangesEnabled | true | Das track-changes-Plugin (Vorschlagsmodus, Annehmen und Ablehnen). Mit false wird es deaktiviert. |
| currentUser | null | { 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. |
| mentionEnabled | true | Das mentions-Plugin. Mit false wird es deaktiviert. Erwähnungen erscheinen erst, wenn eine Quelle gesetzt ist (mentionStaticList, mentionSource oder mentionTriggers). |
| slashCommandEnabled | true | Slash-Befehlsmenü (slash-command-Plugin). Mit false wird es deaktiviert. |
| slashCommandIncludeAi | true | Zeigt die Aktionen des AI Toolkit im Slash-Menü an, wenn das AI Toolkit geladen ist. Mit false werden sie ausgelassen. |
| slashCommands | null | Zusä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. |
| nodeTypesEnabled | true | Registry 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. |
| rubyAnnotationEnabled | true | Ruby-Anmerkungen (rubyannotation-Plugin): Lesehilfen über ostasiatischem Text, als <ruby> mit <rt> geschrieben. Mit false werden sie deaktiviert. |
| rubyAnnotationParentheses | true | Schreibt <rp>-Klammern um jede Lesehilfe, damit Leser ohne Ruby-Unterstützung "base(reading)" anzeigen, statt beide Texte zusammenzuziehen. |
| stateInspectorEnabled | true | Zustandsinspektor (stateinspector-Plugin): Entwicklerpanel mit Dokumentstruktur, Strukturproblemen und kopierbarer Momentaufnahme für Fehlerberichte. Mit false wird es deaktiviert. |
| stateInspectorToolbarButton | false | Fügt eine Symbolleisten-Schaltfläche zum Öffnen des Zustandsinspektors hinzu. Standardmäßig aus; öffnen Sie ihn mit editor.stateInspector.open(). |
| stateInspectorAutoOpen | false | Öffnet den Zustandsinspektor beim Start des Editors. |
| stateInspectorLogLimit | 60 | Anzahl zuletzt gespeicherter Editor-Ereignisse im Inspektor (10 bis 500). |
| stateInspectorMaxDepth | 24 | Tiefe, bis zu der der Inspektor den Dokumentbaum durchläuft (mindestens 2). |
| stateInspectorTitle | State inspector | Titel des Panels. |
| stateInspectorHint | (text) | Zeile unter dem Paneltitel. |
| stateInspectorEmptyText | No content to inspect yet. | Paneltext bei leerem Dokument. |
Dropdown-Menüs anpassen
| Name | Standard | Beschreibung |
|---|---|---|
| paragraphItems | Normal,H1,H2,H3,H4,H5,H6 | Vordefinierte Auswahl von Absatzformaten. |
| fontSizeItems | 8,9,10,11,12,13,14,16, 18,24,36,48,60,72,96 | Vordefinierte Auswahl von Schriftgrößen. |
| fontNameItems | Arial,Arial Black,Comic Sans MS, Courier New,Tahoma,Georgia,Helvetica, Segoe UI,Sans-Serif,Impact, Times New Roman,Verdana | Vordefinierte Auswahl von Schriftarten. |
| lineHeightItems | 100%,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. |
| characterItems | Vordefinierte Auswahl von Zeichen. | |
| foreColorItems | Vordefinierte Auswahl von Textfarben. | |
| backColorItems | Vordefinierte 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.
| Option | Standard | Beschreibung |
|---|---|---|
aiToolkitImageResolver | null | Builds 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. |
galleryAcceptedExtensions | null | Galerie-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. |
tableRowDrag | true | Builds 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. |
tableColumnDrag | true | Builds 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.
| Option | Standard | Beschreibung |
|---|---|---|
ghostText | false | Aktiviert graue Inline-Textvervollständigung. Tab übernimmt, Esc verwirft. |
ghostTextResolver | null | async ({ before }) => string. Erforderlich, damit ghostText wirksam wird. |
aiToolkitReviewLegacyLayout | true | Verwendet das bisherige Seitenpanel-Layout von AI Review. |
aitoolkit_skip_auto_css | true | Unterbindet 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.
| Option | Standard | Beschreibung |
|---|---|---|
autocorrectEnabled | true | Hauptschalter für das autocorrect-Plugin. Schaltet die intelligente Typografie des Editor-Kerns nicht ab; siehe smartTypography. |
autocorrectCapitalize | true | Schreibt den ersten Buchstaben eines Satzes groß. |
autocorrectSpelling | true | Wendet die eingebaute Liste häufiger Rechtschreibfehler an. |
autocorrectTypography | true | Typografische 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. |
autocorrectReplacements | null | Eigene Ersetzungstabelle { from: to }, mit den eingebauten Ersetzungen zusammengeführt. |
emojiAutocompleteEnabled | true | Geben Sie :shortcode: ein, um ein Emoji einzufügen. |
emojiShortcodes | { … } | Überschreibt oder erweitert die Zuordnung von Shortcodes zu Emojis. |
foldHeadingsEnabled | true | Einklappbare Überschriften im Bearbeitungsbereich. |
typewriterModeEnabled | false | Hält die Cursorzeile beim Tippen vertikal an einer festen Position. |
typewriterAnchor | 0.5 | Position der Cursorzeile, von 0 (oben) bis 1 (unten). |
focusModeEnabled | false | Blendet alle Blöcke außer dem Block mit dem Cursor ab. |
dragHandleEnabled | true | Zeigt den Ziehgriff für Blöcke im Randbereich an. |
dragHandleKeyboard | true | Erlaubt das Umordnen von Blöcken per Tastatur (Alt+Up / Alt+Down). |
formattingMarkPilcrow | true | Zeigt Absatzmarken bei aktivierten Formatierungszeichen an. |
formattingMarkBlocks | true | Umrahmt Blockgrenzen bei aktivierten Formatierungszeichen. |
formattingMarkInvisibles | true | Macht 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. |
readabilityStats | true | Zeigt Statistiken zur Lesbarkeit in der Statusleiste an. |
localDraft | false | Speichert 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.
| Option | Standard | Beschreibung |
|---|---|---|
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. |
columnsDefaultCount | 2 | Anzahl 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. |
lineNumberStart | 1 | Erste Zeilennummer. |
lineNumberInterval | 1 | Zeigt jede N-te Zeilennummer an. |
lineNumberRestart | "continuous" | "continuous" oder Neustart je Seite. |
lineNumberGutter | 38 | Breite 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. |
tocMinLevel | 1 | Oberste enthaltene Überschriftenebene. |
tocMaxLevel | 3 | Unterste 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.
| Option | Standard | Beschreibung |
|---|---|---|
paginationEnabled | false | Zeigt 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. |
paginationShowPageNumbers | true | Zeigt Seitenzahlen in der Seitenansicht an. |
paginationShowPageCount | true | Zeigt "of N" neben den Seitenzahlen an. |
docxExport | true | Aktiviert den .docx-Export (im Browser erstellt, ohne Server). |
wordExport | true | Aktiviert den Word-kompatiblen HTML-Export. |
documentImport | true | Aktiviert den .docx-Import. |
pdfExport | true | Aktiviert den Export als Vektor-PDF mit Tags. |
html2pdfScriptUrl | null | Pfad zu html2pdf für den Raster-PDF-Export. Ohne Angabe ist nur der Vektorexport verfügbar. |
markdownExportEnabled | true | Aktiviert Copy / Download as Markdown. |
emailWrapWidth | 640 | Tabellenbreite 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. |
watermarkImage | null | Bild als Wasserzeichen; überschreibt das Textwasserzeichen. |
watermarkMode | "tile" | "tile" oder eine einzelne zentrierte Markierung. |
watermarkOpacity | 0.18 | Deckkraft des Wasserzeichens, 0 bis 1. |
watermarkAngle | -30 | Drehung in Grad. |
watermarkColor | "#94a3b8" | Farbe des Wasserzeichens. |
watermarkFontSize | 48 | Schriftgröße des Wasserzeichens in Pixeln. |
watermarkPrint | false | Druckt das Wasserzeichen mit. |
Medien, Links und Daten
Resolver ermöglichen eigene Datenquellen. Jeder ist eine einfache Funktion; Endpoint und Zugangsdaten bleiben in Ihrer Hand.
| Option | Standard | Beschreibung |
|---|---|---|
autoEmbedEnabled | true | Wandelt eine eingefügte YouTube- oder Vimeo-URL in eine responsive Einbettung um. |
autoEmbedResolver | null | (url) => HTTPS-Einbettungs-URL oder null zum Ablehnen. Ergänzen Sie eigene Anbieter. |
bookmarkResolver | null | (url) => Metadaten für Linkvorschaukarten. |
bookmarkFaviconService | "/favicon-proxy?domain=" | Favicon-Endpoint für Lesezeichenkarten. Verweisen Sie auf Ihren eigenen Proxy. |
diagramResolver | null | Stellen Sie einen Mermaid-Renderer bereit; es wird keiner mitgeliefert. |
diagramSamples | [ … ] | Beispieldiagramme im Einfügedialog. |
drawingWidth | 640 | Zeichnungs-Plugin (drawing.js, nächste Version): Breite der Zeichenfläche in CSS-Pixeln. |
drawingHeight | 360 | Zeichnungs-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. |
chipResolver | null | (query) => Einträge für Smart-Chips. |
chipDateFormat | null | Formatzeichenfolge 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.
| Option | Standard | Beschreibung |
|---|---|---|
defaultTextDirection | null | "ltr", "rtl" oder null zum Erben. |
textDirectionAutoDetect | false | Erkennt die Richtung anhand des eingegebenen Texts. |
textDirectionSwapAlign | true | Spiegelt die Ausrichtung beim Richtungswechsel. |
rtlUserInterface | "auto" | Spiegelt Symbolleiste und Dialoge für RTL-Gebietsschemas. |
a11yEnhance | true | Zugängliche Namen und Rollen für die Editor-Oberfläche. |
dialogA11y | true | Fokusbegrenzung und Beschriftungen innerhalb von Dialogen. |
keyboardA11y | true | Wechselnder tabindex auf Symbolleisten, damit die Tabulatortaste den Editor verlässt. |
readAloudRate | 1.0 | Sprechgeschwindigkeit beim Vorlesen. |
readAloudHighlight | true | Hebt den gerade vorgelesenen Text hervor. |
textPartLanguages | 24 languages | Sprachen im Dropdown-Menü Language: [{ code, label, dir }]. WCAG 3.1.2. |
textPartLanguageHighlight | true | Gepunktete 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.
| Option | Standard | Beschreibung |
|---|---|---|
gapCursorKeys | true | Pfeiltasten/Home/End verlassen eine Tabelle oder einen anderen blockierenden Block am Dokumentrand. |
gapCursorClick | true | Ein Klick in den leeren Raum um Inhalte fügt dort einen Absatz ein. |
gapCursorHint | true | Zeigt einen Einfügehinweis an einer Grenze ohne Höhe zwischen zwei Blöcken. |
multiRootGroup | null | Instanzen mit diesem Gruppennamen arbeiten als ein Editor mit einer einzigen sichtbaren Symbolleiste. |
multiRootName | container id | Name dieses Bereichs in der Gruppen-API (getHTML, focusRoot, …). |
multiRootToolbarHost | null | Element (oder dessen ID), in das die aktive Symbolleiste verschoben wird. null lässt sie an ihrem Ort. |
layoutTableOutline | true | Gestrichelter Rahmen um Layouttabellen beim Bearbeiten. Eine mit role="presentation" markierte Tabelle ist absichtlich unsichtbar; nur so sehen Sie, was Sie bearbeiten. Nur im Editor. |
shadowStyleAdoption | true | Kopiert 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. |
shadowStyleSources | null | Zusä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.
| Option | Standard | Beschreibung |
|---|---|---|
importStyles | false | Hauptschalter. Muss ausdrücklich aktiviert werden, da die Klassenliste auf einer Seite mit Utility-CSS sehr groß ist. |
importStylesSheets | null | Zu 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. |
importStylesFilter | null | (className, selector, bucket) => false zum Überspringen oder eine Zeichenfolge für eine andere Beschriftung. |
importStylesReplace | false | Ersetzt konfigurierte Stile, statt neue anzuhängen. |
importStylesLimit | 100 | Limit 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.
| Option | Standard | Beschreibung |
|---|---|---|
contentSanitizer | true | Positivlistenfilter für Eingabe, Ausgabe und aktives DOM. Lassen Sie ihn eingeschaltet. |
spellCheckEnabled | true | Setzt spellcheck="true" am Bearbeitungsbereich für die Rechtschreibprüfung des Browsers. |
spellCheckResolver | null | (text) => [{ word, offset, length, suggestions }] von einem beliebigen von Ihnen lizenzierten Dienst. |
linkCheckResolver | null | (urls) => Erreichbarkeitsergebnisse für die Linkprüfung. |
linkCheckMixedContent | true | Markiert 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.
| Option | Standard | Beschreibung |
|---|---|---|
revisionHistoryEnabled | true | Mit 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. |
revisionHistoryMaxEntries | 50 | Anzahl gespeicherter Versionen; die ältesten werden zuerst entfernt. |
revisionHistoryAutoSnapshotMs | 0 | Erstellt bei geändertem Inhalt automatisch alle N ms eine Version; 0 = nur auf Anforderung. |
revisionHistorySnapshotBeforeRestore | true | Ab 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. |
revisionHistoryRequestHeaders | null | Header für diesen POST, als Objekt oder als Funktion, die ein Objekt liefert (etwa ein Authentifizierungstoken). |
onRevisionHistorySyncError | null | (detail) => Aufruf bei fehlgeschlagenem POST; die Version bleibt lokal gespeichert. |