Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

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

Zdroje