Document: Methode getSelection()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since November 2017.
Die getSelection()-Methode des Document-Interfaces gibt das Selection-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
Ein Selection-Objekt oder null, wenn das Dokument keinen Browsing 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 range
console.log(selection); // Selection object
Zeichenkettenrepräsentation des Selection-Objekts
Einige Funktionen (wie Window.alert()) rufen toString() automatisch auf und der zurückgegebene Wert wird an die Funktion übergeben. Folglich wird der ausgewählte Text zurückgegeben und nicht das Selection-Objekt:
alert(selection);
Allerdings rufen nicht alle Funktionen toString() automatisch auf. Um ein Selection-Objekt als Zeichenkette zu verwenden, rufen Sie direkt die toString()-Methode auf:
let selectedText = selection.toString();
Verwandte Objekte
Sie können Window.getSelection() aufrufen, welches identisch zu window.document.getSelection() ist.
Es ist zu beachten, dass getSelection() derzeit nicht bei den Inhalten von <input>-Elementen in Firefox funktioniert.
HTMLInputElement.setSelectionRange()) könnte als Workaround verwendet werden.
Beachten Sie auch den Unterschied zwischen selection und focus.
Document.activeElement gibt das fokussierte Element zurück.
Spezifikationen
| Specification |
|---|
| Selection API # dom-document-getselection |