DiegetSelection()-Methode desDocument-Interfaces gibt dasSelection-Objekt zurück, das mit diesem Dokument verbunden ist. Es repräsentiert den vom Benutzer ausgewählten Textbereich oder die aktuelle Position des Cursors.

Syntax

getSelection()

Parameter

Keine.

Rückgabewert

EinSelection-Objekt odernull, wenn das Dokument keinenBrowsing Context hat (zum Beispiel, wenn es sich um das Dokument eines nicht an ein Dokument angehängten<iframe> handelt).

Beispiele

Ein Selection-Objekt abrufen

const selection = document.getSelection();const selRange = selection.getRangeAt(0);// do stuff with the rangeconsole.log(selection); // Selection object

Zeichenkettenrepräsentation des Selection-Objekts

Einige Funktionen (wieWindow.alert()) rufentoString() automatisch auf und der zurückgegebene Wert wird an die Funktion übergeben. Folglich wird der ausgewählte Text zurückgegeben und nicht dasSelection-Objekt:

alert(selection);

Allerdings rufen nicht alle FunktionentoString() automatisch auf. Um einSelection-Objekt als Zeichenkette zu verwenden, rufen Sie direkt dietoString()-Methode auf:

let selectedText = selection.toString();

Verwandte Objekte

Sie könnenWindow.getSelection() aufrufen, welches identisch zuwindow.document.getSelection() ist.

Es ist zu beachten, dassgetSelection() derzeit nicht bei den Inhalten von<input>-Elementen in Firefox funktioniert.HTMLInputElement.setSelectionRange()) könnte als Workaround verwendet werden.

Beachten Sie auch den Unterschied zwischenselection undfocus.Document.activeElement gibt das fokussierte Element zurück.

Spezifikationen

Browser-Kompatibilität