Zum Hauptinhalt springen

API-Übersicht

RichText-Konstruktor

new richtext.RichText("#root", {
// Konfigurationsparameter
});

Parameter:

  • ein HTML-Container (z. B. CSS-Selektor oder DOM-Element)
  • ein Konfigurationsobjekt (siehe Eigenschaften)

RichText-Methoden

NameBeschreibung
getValue()Gibt den Wert des RichText zurück
setValue()Wendet einen neuen Wert auf RichText an
insertValue()Fügt Text, Markdown oder HTML-Inhalt an der aktuellen Cursorposition ein oder ersetzt den markierten Text
setConfig()Wendet neue Konfigurationsparameter auf RichText an
setLocale()Wendet ein neues Gebietsschema auf RichText an
destructor()Entfernt alle HTML-Elemente von RichText und trennt alle zugehörigen Events

Event-Bus-Methoden

NameBeschreibung
api.exec()Ermöglicht das Auslösen interner Events
api.intercept()Ermöglicht das Abfangen und Verhindern interner Events
api.on()Ermöglicht das Anbinden eines Handlers an interne Events
api.detach()Ermöglicht das Entfernen/Trennen von Event-Handlern
api.setNext()Ermöglicht das Hinzufügen einer Aktion in die Event-Bus-Reihenfolge

State-Methoden

NameBeschreibung
api.getState()Gibt ein Objekt mit den StateStore-Eigenschaften von RichText zurück
api.getReactiveState()Gibt ein Objekt mit den reaktiven Eigenschaften von RichText zurück

Events

NameBeschreibung
alignWird ausgelöst, wenn die Textausrichtung über die Menüleiste/Toolbar oder Event-Bus-Methoden geändert wird
clear-text-formatWird ausgelöst, wenn eine Textformatierung über die Menüleiste/Symbolleiste oder Event-Bus-Methoden aufgehoben wird
copyWird ausgelöst, wenn ausgewählter Text kopiert wird
create-newWird ausgelöst, wenn die Option „Neu" in der Menüleiste oder über Event-Bus-Methoden aufgerufen wird
cutWird ausgelöst, wenn ausgewählter Text ausgeschnitten wird
delete-linkWird ausgelöst, wenn ein Link gelöscht wird
exportWird ausgelöst, nachdem die Option „Export" in der Menüleiste oder über Event-Bus-Methoden aufgerufen wurde
importWird ausgelöst, nachdem die Option "Import" in der Menüleiste oder über Event-Bus-Methoden aufgerufen wird
indentWird ausgelöst, wenn der Block-Einzug erhöht wird
insert-imageWird ausgelöst, wenn ein Bild eingefügt wird (über die Toolbar, die Menüleiste, die Zwischenablage oder Drag-and-Drop)
insert-lineWird ausgelöst, wenn eine horizontale Linie eingefügt wird
insert-linkWird ausgelöst, wenn ein Link eingefügt wird
insert-listWird beim Einfügen einer Liste ausgelöst
outdentWird ausgelöst, wenn der Block-Einzug verringert wird
pasteWird ausgelöst, wenn Inhalt eingefügt wird
printWird beim Drucken des Dokuments ausgelöst
redoWird ausgelöst, wenn die Schaltfläche „Redo" in der Menüleiste/Toolbar gedrückt oder über Event-Bus-Methoden aufgerufen wird
resize-imageWird ausgelöst, wenn ein Bild in der Größe geändert wird
set-font-familyWird ausgelöst, wenn eine Schriftfamilie gesetzt wird
set-font-sizeWird ausgelöst, wenn eine Schriftgröße festgelegt wird
set-line-heightWird ausgelöst, wenn eine Zeilenhöhe gesetzt wird
set-text-colorWird ausgelöst, wenn eine Textfarbe und/oder eine Texthintergrundfarbe gesetzt wird
set-text-formatWird ausgelöst, wenn ein Textformat gesetzt wird
set-text-styleWird ausgelöst, wenn ein Textstil gesetzt wird
show-popupWird ausgelöst, wenn ein Popup angezeigt oder ausgeblendet wird
subscriptWird ausgelöst, wenn die Schaltfläche „Subscript" in der Menüleiste/Toolbar oder über Event-Bus-Methoden gedrückt wird
superscriptWird ausgelöst, wenn die Schaltfläche „Hochgestellt" in der Menüleiste/Toolbar oder über Event-Bus-Methoden gedrückt wird
toggle-fullscreen-modeWird ausgelöst, wenn der Vollbildmodus umgeschaltet wird
toggle-layout-modeWird ausgelöst, wenn der Layout-Modus umgeschaltet wird
toggle-shortcut-infoWird ausgelöst, wenn die Shortcut-Info ein- oder ausgeblendet wird
undoWird ausgelöst, wenn die Schaltfläche „Undo" in der Menüleiste/Toolbar gedrückt oder über Event-Bus-Methoden aufgerufen wird
update-linkWird ausgelöst, wenn ein Link aktualisiert wird

Eigenschaften

NameBeschreibung
defaultStylesOptional. Legt Standard-Stilwerte für bestimmte Block-Typen fest
fullscreenModeOptional. Aktiviert den Vollbildmodus von RichText
imageUploadUrlOptional. Gibt die URL an, die für den Bild-Upload verwendet wird (über Toolbar, Menüleiste, Zwischenablage-Einfügen oder Drag-and-Drop)
layoutModeOptional. Legt den Layout-Modus für den Haupteditorbereich fest
localeOptional. Ein Objekt, das Lokalisierungsbeschriftungen von RichText enthält
menubarOptional. Aktiviert die obere Menüleiste von RichText
toolbarOptional. Aktiviert die Toolbar und erlaubt es, die darin angezeigten Schaltflächen anzugeben und zu konfigurieren
valueOptional. Legt den Anfangswert (Inhalt) fest, der im Editorbereich von RichText angezeigt wird