Auswahl: setPosition()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit August 2017 browserübergreifend verfügbar.
Die Selection.setPosition()-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.collapse()-Methode.
Syntax
setPosition(node)
setPosition(node, offset)
Parameter
node-
Die Position des Cursors wird innerhalb dieses Knotens liegen. 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, auf den 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().setPosition(body, 0);
Spezifikationen
| Spezifikation |
|---|
| Selection API # dom-selection-collapse |