Auswahl: setPosition()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since August 2017.

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 null gesetzt werden — wenn null angegeben ist, verhält sich die Methode wie Selection.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 Standardwert 0 verwendet.

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

Specification
Selection API # dom-selection-collapse

Browser-Kompatibilität

Siehe auch

Selection.collapse()