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 ist eine Zahl, die den Anfangsindex des ausgewählten Textes darstellt. Sie kann verwendet werden, um sowohl den Anfangsindex des ausgewählten Textes abzurufen als auch festzulegen.

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

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

Der Eigenschaftswert kann abgerufen und festgelegt werden, ohne dass das <textarea> den Fokus hat, aber das Element muss den Fokus haben, damit das ::selection-Pseudo-Element den ausgewählten Text zuordnen kann.

Das Setzen des selectionStart auf einen neuen Wert löst die Ereignisse selectchange und select aus.

Wert

Eine nicht-negative Zahl.

Beispiele

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

Spezifikationen

Specification
HTML Standard
# dom-textarea/input-selectionstart

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch