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
selectstartEreignis wird ausgelöst, wenn der Benutzer beginnt, eine neue Auswahl zu treffen - das
selectionchangeEreignis 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
SelectionObjekt zurückgibt, das die aktuelle Auswahl oder die aktuelle Position des Cursors repräsentiert. Window.getSelection()-
Eine Methode, die ein
SelectionObjekt 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.
Spezifikationen
| Specification |
|---|
| Selection API> # selection-interface> |