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 Textauswahl in einem <textarea>-Element an. Es ist eine Zahl, die den letzten Index des ausgewählten Textes darstellt. Mit ihr kann sowohl der Index des Endes des ausgewählten Textes in einem <textarea> abgerufen als auch gesetzt werden.

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

Wenn selectionEnd auf einen Wert kleiner als der aktuelle Wert von selectionStart gesetzt wird, werden sowohl die Eigenschaften selectionEnd als auch selectionStart 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-Pseudoelement den ausgewählten Text übereinstimmt.

Wenn selectionEnd auf einen neuen Wert gesetzt wird, werden die Ereignisse selectchange und select ausgelöst.

Wert

Eine nicht-negative Zahl.

Beispiele

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

Spezifikationen

Specification
HTML Standard
# dom-textarea/input-selectionend

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch