CKTIS / JavaScript
HTMLTextAreaElement.selectionStart — Anfang der Auswahl
HTMLTextAreaElement.selectionStart liest oder setzt den Anfang der Auswahl in einem textarea-Element. Der nullbasierte Offset zählt UTF-16-Codeeinheiten statt sichtbarer Zeichen.
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.selectionStart
textarea.selectionStart = offsetHTMLTextAreaElement.selectionStart ist eine beschreibbare Eigenschaft eines textarea-Steuerelements. Zusammen mit selectionEnd legt sie einen Bereich fest: Der Anfang ist eingeschlossen, das Ende ausgeschlossen. Ohne Auswahl zeigen beide Werte auf die Einfügemarke.
Die Offsets zählen UTF-16-Codeeinheiten in value: 😀 belegt zwei. Bei der Zuweisung wandelt Web IDL den Wert zunächst in eine vorzeichenlose 32-Bit-Ganzzahl um. Die Position wird nur dann auf das Textende begrenzt, wenn der umgewandelte Wert die Textlänge überschreitet. Die Zuweisung von 2 ** 32 setzt den Anfang beispielsweise auf 0, weil die Umwandlung 0 ergibt. Liegt der so ermittelte Anfang hinter dem bisherigen Ende, wird das Ende an dieselbe Position verschoben und die Auswahl dadurch aufgehoben.
Dies ist eine Browser-API aus dem HTML Standard, keine ECMAScript-Funktion; eine Node.js-Version allein belegt nicht, dass sie unterstützt wird. Das Beispiel verwendet ein nicht in das Dokument eingefügtes Steuerelement: Sein Auswahlstatus lässt sich ohne Darstellung auslesen.
Beispiele
const textarea = document.createElement('textarea');
textarea.value = 'A😀BC';
textarea.setSelectionRange(1, 3);
console.log(textarea.selectionStart, textarea.selectionEnd);
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));
textarea.selectionStart = 4;
console.log(textarea.selectionStart, textarea.selectionEnd);Ergebnis
1 3 😀 4 4
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.