HTMLTextAreaElement: selectionStart Eigenschaft

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. Sie kann verwendet werden, um sowohl den Anfangsindex des ausgewählten Textes in einem <textarea> abzurufen als auch festzulegen.

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

Wenn selectionStart auf einen Wert größer als der aktuelle Wert von selectionEnd gesetzt wird, aktualisiert dies sowohl die selectionStart- als auch die selectionEnd-Eigenschaft 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 gesetzt werden, ohne dass das <textarea> den Fokus hat, allerdings muss das Element den Fokus haben, damit das ::selection Pseudo-Element mit dem ausgewählten Text übereinstimmt.

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

Wert

Eine nicht-negative Zahl.

Beispiele

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• <textarea>
• HTMLTextAreaElement
• HTMLTextAreaElement.selectionEnd
• HTMLTextAreaElement.selectionDirection
• HTMLTextAreaElement.textLength
• HTMLTextAreaElement.select()
• HTMLTextAreaElement.setSelectionRange()
• HTMLTextAreaElement.setRangeText()
• HTMLInputElement.selectionStart
• Selection
• ::selection Pseudo-Element