HTMLTextAreaElement: selectionStart-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
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 Startindex des Beginns eines <textarea>-ausgewählten Textes abzurufen als auch zu setzen.
Wenn nichts ausgewählt ist, entspricht der Wert von sowohl selectionStart als auch selectionEnd der Position des Cursors innerhalb des <textarea>-Elements.
Wenn selectionStart auf einen Wert größer als der aktuelle Wert von selectionEnd gesetzt wird, aktualisieren sich sowohl die selectionStart- als auch selectionEnd-Eigenschaften auf diesen Wert. Ist dieser Wert gleich oder größer als die textLength, werden beide Eigenschaften auf den Wert der textLength-Eigenschaft gesetzt.
Der Eigenschaftswert kann abgerufen und gesetzt werden, ohne dass der <textarea> den Fokus haben muss, aber das Element benötigt den Fokus, damit das ::selection Pseudoelement dem ausgewählten Text entspricht.
Das Setzen von selectionStart auf einen neuen Wert löst die selectionchange- und select-Events aus.
Wert
Eine nicht-negative Zahl.
Beispiele
const textarea = document.getElementById("text-box");
const start = textarea.selectionStart;
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-textarea/input-selectionstart |
Browser-Kompatibilität
Siehe auch
<textarea>HTMLTextAreaElementHTMLTextAreaElement.selectionEndHTMLTextAreaElement.selectionDirectionHTMLTextAreaElement.textLengthHTMLTextAreaElement.select()HTMLTextAreaElement.setSelectionRange()HTMLTextAreaElement.setRangeText()HTMLInputElement.selectionStartSelection::selectionPseudoelement