Window: Methode getSelection()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die Methode getSelection() der Schnittstelle Window gibt das Selection-Objekt zurück, das dem document des Fensters zugeordnet ist. Es repräsentiert den vom Benutzer ausgewählten Textbereich oder die aktuelle Position der Einfügemarke.
window.getSelection() ist eine Kurzform für window.document.getSelection(). Weitere Informationen finden Sie unter Document.getSelection().
Syntax
getSelection()
Parameter
Keine.
Rückgabewert
Ein Selection-Objekt oder null, wenn das zugehörige Dokument keinen Browsing Context hat (beispielsweise wenn das Fenster ein <iframe> ist, das nicht in ein Dokument eingebunden ist).
Wird die Methode für ein <iframe> aufgerufen, das nicht angezeigt wird (z. B. weil display: none gesetzt ist), gibt Firefox null zurück. Andere Browser geben dagegen ein Selection-Objekt zurück, bei dem Selection.type auf None gesetzt ist.
Beispiele
Ein Selection-Objekt abrufen
const selection = window.getSelection();
const selRange = selection.getRangeAt(0);
// do stuff with the range
console.log(selection); // Selection object
Spezifikationen
| Spezifikation |
|---|
| Selection API # dom-window-getselection |