HTMLTextAreaElement: selectionStart-Eigenschaft

Baseline Widely available

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

Die selectionStart-Eigenschaft des HTMLTextAreaElement-Interfaces gibt die Startposition der aktuellen Textauswahl in einem <textarea>-Element an. Es handelt sich dabei um eine Zahl, die den Anfangsindex des ausgewählten Textes darstellt. Diese Eigenschaft kann verwendet werden, um sowohl den Startindex des ausgewählten Textes in einem <textarea> abzurufen als auch festzulegen.

Wenn nichts ausgewählt ist, entspricht der Wert von sowohl selectionStart als auch selectionEnd der Position des Cursors (Einfügemarke) innerhalb des <textarea>-Elements.

Wird selectionStart auf einen Wert gesetzt, der größer ist als der aktuelle Wert von selectionEnd, werden sowohl die selectionStart- als auch die selectionEnd-Eigenschaften auf diesen Wert aktualisiert. Sollte dieser Wert gleich oder größer als die textLength sein, werden beide Eigenschaften auf den Wert der textLength-Eigenschaft gesetzt.

Der Eigenschaftswert kann abgerufen und gesetzt werden, ohne dass das <textarea> den Fokus haben muss. Jedoch muss das Element den Fokus haben, damit das ::selection-Pseudo-Element den ausgewählten Text übereinstimmt.

Das Setzen eines neuen Wertes für selectionStart löst die selectchange- und select-Ereignisse aus.

Wert

Eine nicht-negative Zahl.

Beispiele

js
const textarea = document.getElementById("text-box");
const start = textarea.selectionStart;

Spezifikationen

Specification
HTML
# dom-textarea/input-selectionstart

Browser-Kompatibilität

Siehe auch