Document: getSelection()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit November 2017 browserübergreifend verfügbar.
Die getSelection()-Methode der Document-Schnittstelle gibt das diesem Dokument zugeordnete Selection-Objekt zurück. Es repräsentiert den vom Benutzer ausgewählten Textbereich oder die aktuelle Position des Textcursors.
Syntax
getSelection()
Parameter
Keine.
Rückgabewert
Ein Selection-Objekt oder null, wenn das Dokument keinen Browsing Context hat (beispielsweise, wenn es das Dokument eines <iframe> ist, das nicht an ein Dokument angehängt ist).
Hinweise zur Verwendung
Sie können auch Window.getSelection() aufrufen. Dies ist identisch mit window.document.getSelection().
Derzeit funktioniert getSelection() in Firefox nicht für den Inhalt von <textarea>- und <input>-Elementen.
Als Umgehung können Sie HTMLInputElement.setSelectionRange() oder die Eigenschaften selectionStart und selectionEnd verwenden.
Beachten Sie auch den Unterschied zwischen Auswahl und Fokus. Document.activeElement gibt das fokussierte Element zurück.
Beispiele
Ein Selection-Objekt abrufen
const selection = document.getSelection();
const selRange = selection.getRangeAt(0);
// do stuff with the range
console.log(selection); // Selection object
Spezifikationen
| Spezifikation |
|---|
| Selection API # dom-document-getselection |