HTMLTextAreaElement: selectionEnd-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 selectionEnd-Eigenschaft des HTMLTextAreaElement-Interfaces gibt die Endposition der aktuellen Textselektion in einem <textarea>-Element an. Es ist eine Zahl, die den letzten Index des ausgewählten Textes darstellt. Sie kann sowohl zum Abrufen als auch zum Festlegen des Indexes des Endes eines \<textarea> ausgewählten Textes verwendet werden.

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

Wenn selectionEnd auf einen Wert kleiner als der aktuelle Wert von selectionStart gesetzt wird, werden sowohl die selectionEnd- als auch die selectionStart-Eigenschaften auf diesen Wert aktualisiert. Wenn beide Werte kleiner als 0 sind, 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 den ausgewählten Text zuordnen kann.

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

Wert

Eine nicht-negative Zahl.

Beispiele

js
const textarea = document.getElementById("text-box");
const end = textarea.selectionEnd;

Spezifikationen

Specification
HTML
# dom-textarea/input-selectionend

Browser-Kompatibilität

Siehe auch