CKTIS / JavaScript
HTMLTextAreaElement.selectionStart — začiatok výberu
HTMLTextAreaElement.selectionStart číta alebo nastavuje začiatok výberu v prvku textarea. Offset počítaný od nuly vyjadruje jednotky kódu UTF-16, nie viditeľné znaky.
Verzia: 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 je zapisovateľná vlastnosť ovládacieho prvku textarea. Spolu s selectionEnd určuje rozsah: začiatok je zahrnutý a koniec nezahrnutý. Ak nie je nič vybraté, obe hodnoty označujú pozíciu kurzora.
Offsety počítajú jednotky kódu UTF-16 v value: 😀 zaberá dve. Pri priradení Web IDL najprv prevedie hodnotu na 32-bitové celé číslo bez znamienka. Pozícia sa obmedzí na koniec textu iba vtedy, ak prevedená hodnota presahuje dĺžku textu. Napríklad priradenie 2 ** 32 nastaví začiatok na 0, pretože výsledkom prevodu je 0. Ak je takto určený začiatok za doterajším koncom, koniec sa posunie na rovnakú pozíciu a výber sa tým zruší.
Ide o rozhranie prehliadača z HTML Standard, nie o funkciu ECMAScript; samotná verzia Node.js nepreukazuje jeho podporu. Príklad používa ovládací prvok nepripojený k dokumentu: jeho stav výberu možno čítať bez vykreslenia.
Prí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ýsledok
1 3 😀 4 4
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.