Selection: collapse() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die Selection.collapse() Methode reduziert die aktuelle Auswahl auf einen einzigen Punkt. Das Dokument wird nicht verä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-
Der Cursor wird innerhalb dieses Knotens positioniert. Dieser Wert kann auch auf
nullgesetzt werden — wennnullangegeben ist, verhält sich die Methode wieSelection.removeAllRanges(), d.h. alle Bereiche werden aus der Auswahl entfernt. offsetOptional-
Der Versatz in
node, zu dem die Auswahl reduziert wird. Wenn nicht angegeben, wird der Standardwert0verwendet.
Rückgabewert
Keiner (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
| Spezifikation |
|---|
| Selection API # dom-selection-collapse |