EditContext

Die EditContext-Schnittstelle repräsentiert den Textbearbeitungskontext eines Elements, das durch die Verwendung der EditContext API bearbeitbar gemacht wurde.

Die EditContext API kann verwendet werden, um Rich-Text-Editoren im Web zu erstellen, die fortschrittliche Texterfahrung unterstützen, wie beispielsweise die Komposition mit einem Input Method Editor (IME), Emoji-Auswahl oder andere plattformabhängige UI-Oberflächen für die Bearbeitung.

Konstruktor

EditContext()

Gibt eine neue EditContext-Instanz zurück.

Instanz-Eigenschaften

EditContext.text Schreibgeschützt

Der bearbeitbare Inhalt des Elements.

EditContext.selectionStart Schreibgeschützt

Der Offset innerhalb des bearbeitbaren Textinhalts, der den Anfang der aktuellen Auswahl darstellt.

EditContext.selectionEnd Schreibgeschützt

Der Offset innerhalb des bearbeitbaren Textinhalts, der das Ende der aktuellen Auswahl darstellt.

EditContext.characterBoundsRangeStart Schreibgeschützt

Der Offset innerhalb des bearbeitbaren Textinhalts, an dem die letzte IME-Komposition begann.

Instanz-Methoden

EditContext basiert auf der EventTarget-Schnittstelle und beinhaltet deren Methoden.

EditContext.attachedElements()

Ein Array, das ein HTMLElement-Objekt enthält, welches das Element darstellt, das mit dem EditContext-Objekt assoziiert ist.

EditContext.characterBounds()

Die Liste von Begrenzungsrechtecken für die Zeichen im EditContext-Objekt.

EditContext.updateText()

Aktualisiert den internen Textinhalt des EditContext-Objekts.

EditContext.updateSelection()

Aktualisiert den internen Zustand der Auswahl innerhalb des bearbeitbaren Textkontexts.

EditContext.updateControlBounds()

Informiert das Betriebssystem über die Position und Größe des bearbeitbaren Textbereichs.

EditContext.updateSelectionBounds()

Informiert das Betriebssystem über die Position und Größe der Auswahl innerhalb des bearbeitbaren Textbereichs.

EditContext.updateCharacterBounds()

Informiert das Betriebssystem über die Position und Größe der Zeichen im EditContext-Objekt.

Ereignisse

textupdate

Wird ausgelöst, wenn der Benutzer Änderungen am Text oder der Auswahl vorgenommen hat.

textformatupdate

Wird ausgelöst, wenn eine Komposition mit einem Input Method Editor (IME)-Fenster erfolgt und der IME entscheidet, dass bestimmte Teile des komponierten Textes unterschiedlich formatiert werden sollten, um den Kompositionsstatus anzuzeigen.

characterboundsupdate

Wird ausgelöst, wenn das Betriebssystem die Größe und Position bestimmter Zeichen innerhalb des bearbeitbaren Textbereichs des EditContext-Objekts kennen muss, um ein IME-Fenster anzuzeigen.

compositionstart

Wird ausgelöst, wenn eine Komposition mit einem IME-Fenster beginnt.

compositionend

Wird ausgelöst, wenn eine Komposition mit einem IME-Fenster endet.

Spezifikationen

Browser-Kompatibilität