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 Texts darstellt. Diese Eigenschaft kann verwendet werden, um sowohl den Anfangsindex des ausgewählten Textes zu ermitteln als auch festzulegen.

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

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

Der Eigenschaftswert kann abgerufen und festgelegt werden, ohne dass das <textarea> den Fokus hat, aber das Element muss fokussiert sein, damit das ::selection-Pseudoelement den ausgewählten Text übereinstimmt.

Das Einstellen von selectionStart auf einen neuen Wert löst die Ereignisse selectionchange und select 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