Selection API

Hinweis: Diese API ist nicht verfügbar in Web Workers (nicht über WorkerNavigator zugänglich).

Die Selection API ermöglicht es Entwicklern, auf den vom Benutzer ausgewählten Teil eines Dokuments zuzugreifen und diesen zu manipulieren.

Die Methoden Window.getSelection() und Document.getSelection() geben ein Selection Objekt zurück, das den vom Benutzer ausgewählten Teil des Dokuments repräsentiert. Ein Selection Objekt bietet Methoden, um:

auf die derzeit ausgewählten Knoten zuzugreifen
die aktuelle Auswahl zu ändern, sie zu erweitern oder zu verkleinern oder einen völlig anderen Teil des Dokuments auszuwählen
Teile der aktuellen Auswahl aus dem DOM zu löschen.

Die Selection API bietet auch zwei Ereignisse, die beide auf Document ausgelöst werden:

das selectstart Ereignis wird ausgelöst, wenn der Benutzer beginnt, eine neue Auswahl zu treffen
das selectionchange Ereignis wird ausgelöst, wenn sich die aktuelle Auswahl ändert.

Schnittstellen

Selection: Eine Schnittstelle, die den vom Benutzer ausgewählten Teil des Dokuments oder die aktuelle Position des Cursors repräsentiert.
Document.getSelection(): Eine Methode, die ein Selection Objekt zurückgibt, das die aktuelle Auswahl oder die aktuelle Position des Cursors repräsentiert.
Window.getSelection(): Eine Methode, die ein Selection Objekt zurückgibt, das die aktuelle Auswahl oder die aktuelle Position des Cursors repräsentiert.
Document.selectionchange: Ein Ereignis, das ausgelöst wird, wenn die aktuelle Auswahl geändert wird.
Node.selectstart: Ein Ereignis, das ausgelöst wird, wenn ein Benutzer eine neue Auswahl beginnt.

Specification
Selection API # selection-interface