Dokument: Methode getSelection()
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 Methode getSelection() der Schnittstelle Document 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 sich um das Dokument eines <iframe> handelt, das nicht in ein Dokument eingebunden ist).
Beispiele
Ein Selection-Objekt abrufen
const selection = document.getSelection();
const selRange = selection.getRangeAt(0);
// do stuff with the range
console.log(selection); // Selection object
Zeichenfolgendarstellung des Selection-Objekts
Einige Funktionen (wie Window.alert()) rufen toString() automatisch auf und erhalten den Rückgabewert als Argument. Daher wird der ausgewählte Text übergeben und nicht das Selection-Objekt:
alert(selection);
Allerdings rufen nicht alle Funktionen toString() automatisch auf. Um ein Selection-Objekt als Zeichenfolge zu verwenden, rufen Sie dessen Methode toString() direkt auf:
let selectedText = selection.toString();
Verwandte Objekte
Sie können Window.getSelection() aufrufen; dies ist identisch mit window.document.getSelection().
Beachten Sie, dass getSelection() derzeit in Firefox nicht für den Inhalt von <input>-Elementen funktioniert. Als Umgehung können Sie HTMLInputElement.setSelectionRange() verwenden.
Beachten Sie auch den Unterschied zwischen Auswahl und Fokus. Document.activeElement gibt das fokussierte Element zurück.
Spezifikationen
| Spezifikation |
|---|
| Selection API # dom-document-getselection |