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
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
collapse | ||||||||||||
Accepts node parameter in any tree/shadow tree | ||||||||||||
node parameter is nullable | ||||||||||||
offset parameter is optional |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- In development. Supported in a pre-release version.
- In development. Supported in a pre-release version.
- No support
- No support
- Experimental. Expect behavior to change in the future.