Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

HTMLTextAreaElement.selectionStart — začátek výběru

HTMLTextAreaElement.selectionStart čte nebo nastavuje začátek výběru v prvku textarea. Offset počítaný od nuly vyjadřuje jednotky kódu UTF-16, nikoli viditelné znaky.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

textarea.selectionStart
textarea.selectionStart = offset

HTMLTextAreaElement.selectionStart je zapisovatelná vlastnost ovládacího prvku textarea. Společně s selectionEnd určuje rozsah: začátek je zahrnutý, konec nezahrnutý. Pokud není nic vybráno, obě hodnoty označují pozici kurzoru.

Offsety počítají jednotky kódu UTF-16 v value: 😀 zabírá dvě. Při přiřazení Web IDL nejprve převede hodnotu na 32bitové celé číslo bez znaménka. Pozice se omezí na konec textu pouze tehdy, pokud převedená hodnota přesahuje délku textu. Například přiřazení 2 ** 32 nastaví začátek na 0, protože výsledkem převodu je 0. Pokud takto určený začátek leží za dosavadním koncem, konec se posune na stejnou pozici a výběr se tím zruší.

Jde o rozhraní prohlížeče z HTML Standard, nikoli o funkci ECMAScript; samotná verze Node.js neprokazuje jeho podporu. Příklad používá ovládací prvek odpojený od dokumentu: jeho stav výběru lze číst bez vykreslení.

Příklady

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);

Výsledek

1 3
😀
4 4

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje