WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 = offset

HTMLTextAreaElement.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.

Quellen