CKTIS / JavaScript
HTMLTextAreaElement.selectionEnd — Ende der Auswahl
HTMLTextAreaElement.selectionEnd liest oder setzt die Endgrenze einer Auswahl in einem textarea. Der nullbasierte Offset wird in UTF-16-Codeeinheiten gemessen; die Endposition gehört nicht zur Auswahl.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
textarea.selectionEnd
textarea.selectionEnd = endHTMLTextAreaElement.selectionEnd ist eine Lese- und Schreib-Eigenschaft. Sie bezeichnet die Position direkt hinter dem ausgewählten Text in textarea.value. selectionStart und selectionEnd geben einen eingeschlossenen Anfang und ein ausgeschlossenes Ende an. Gibt es keine Auswahl, stehen beide Werte für die Cursorposition.
Offsets zählen UTF-16-Codeeinheiten, nicht sichtbare Zeichen: Manche Emojis belegen zwei Einheiten. Bei textarea verwendet die API den Wert mit normalisierten Zeilenenden und nicht den Rohtext mit CR-Zeichen.
Eine Zuweisung ändert die Auswahlgrenze, nicht den Text. Web IDL wandelt den zugewiesenen Wert zuerst in den Typ unsigned long um. Überschreitet der umgewandelte Wert die Textlänge, wird er auf diese Länge begrenzt. Beispielsweise ergibt 2 ** 32 bei der Umwandlung 0. Die Zuweisung setzt das Ende daher auf 0 und nicht auf die Textlänge eines nicht leeren textarea-Elements. Liegt das neue Ende vor selectionStart, wird auch der Anfang auf das neue Ende verschoben und die Auswahl damit aufgehoben. Mit setSelectionRange(start, end) lassen sich beide Grenzen gemeinsam festlegen.
Der Auswahlzustand besteht auch bei einem nicht dargestellten Element. Daher fügt das Beispiel das Steuerelement nicht in das Dokument ein. Dies ist eine Browser-API des HTML-Standards und keine ECMAScript-Sprachfunktion; die Verfügbarkeit von Node 24 belegt nicht, dass sie verfügbar ist.
Beispiele
const textarea = document.createElement('textarea');
textarea.value = 'Hello world';
textarea.setSelectionRange(0, 5);
console.log(textarea.selectionEnd);
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));
textarea.selectionEnd = 3;
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));Ergebnis
5 Hello Hel
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.