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 der HTMLTextAreaElement-Schnittstelle gibt die Startposition der aktuellen Textauswahl in einem <textarea>-Element an. Es handelt sich um eine Zahl, die den Anfangsindex des ausgewählten Textes repräsentiert. Sie kann verwendet werden, um sowohl den Startindex des ausgewählten Textes abzurufen als auch festzulegen.

Wenn nichts ausgewählt ist, entspricht der Wert von selectionStart und selectionEnd der Position des Cursors (Eingabemarkierung) innerhalb des <textarea>-Elements.

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

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

Das Festlegen 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

BCD tables only load in the browser

Siehe auch