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 = offsetHTMLTextAreaElement.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.