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 March 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 |
Browser-Kompatibilität
BCD tables only load in the browser