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 handelt sich dabei um eine Zahl, die den Anfangsindex des ausgewählten Textes darstellt. Diese Eigenschaft kann verwendet werden, um sowohl den Startindex des ausgewählten Textes in einem <textarea>
abzurufen als auch festzulegen.
Wenn nichts ausgewählt ist, entspricht der Wert von sowohl selectionStart
als auch selectionEnd
der Position des Cursors (Einfügemarke) innerhalb des <textarea>
-Elements.
Wird selectionStart
auf einen Wert gesetzt, der größer ist als der aktuelle Wert von selectionEnd
, werden sowohl die selectionStart
- als auch die selectionEnd
-Eigenschaften auf diesen Wert aktualisiert. Sollte dieser Wert gleich oder größer als die textLength
sein, werden beide Eigenschaften auf den Wert der textLength
-Eigenschaft gesetzt.
Der Eigenschaftswert kann abgerufen und gesetzt werden, ohne dass das <textarea>
den Fokus haben muss. Jedoch muss das Element den Fokus haben, damit das ::selection
-Pseudo-Element den ausgewählten Text übereinstimmt.
Das Setzen eines neuen Wertes für selectionStart
löst die selectchange
- und select
-Ereignisse aus.
Wert
Eine nicht-negative Zahl.
Beispiele
const textarea = document.getElementById("text-box");
const start = textarea.selectionStart;
Spezifikationen
Specification |
---|
HTML # dom-textarea/input-selectionstart |
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