Selection: collapse() Methode
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 Selection.collapse()
Methode reduziert die aktuelle Auswahl auf einen einzigen Punkt. Das Dokument wird nicht geändert. Wenn der Inhalt fokussiert und bearbeitbar ist, wird der Cursor dort blinken.
Hinweis: Diese Methode ist ein Alias für die Selection.setPosition()
Methode.
Syntax
collapse(node)
collapse(node, offset)
Parameter
node
-
Die Cursorposition wird in diesem Knoten sein. Dieser Wert kann auch auf
null
gesetzt werden – wennnull
angegeben ist, verhält sich die Methode wieSelection.removeAllRanges()
; d.h. alle Bereiche werden aus der Auswahl entfernt. offset
Optional-
Der Versatz in
node
, auf den die Auswahl reduziert wird. Wenn nicht angegeben, wird der Standardwert0
verwendet.
Rückgabewert
Keine (undefined
).
Beispiele
// Place the caret at the beginning of an HTML document's body.
const body = document.querySelector("body");
window.getSelection().collapse(body, 0);
Spezifikationen
Specification |
---|
Selection API # dom-selection-collapse |
Browser-Kompatibilität
BCD tables only load in the browser