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

CKTIS / JavaScript

HTMLTextAreaElement.selectionEnd — koniec výberu

HTMLTextAreaElement.selectionEnd umožňuje prečítať alebo nastaviť koncovú hranicu výberu v prvku textarea. Ide o offset počítaný od nuly v jednotkách kódu UTF-16; koncová pozícia nie je súčasťou výberu.

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.selectionEnd
textarea.selectionEnd = end

HTMLTextAreaElement.selectionEnd je vlastnosť na čítanie aj zápis. Označuje pozíciu bezprostredne za vybraným textom v textarea.value. selectionStart a selectionEnd opisujú zahrnutý začiatok a nezahrnutý koniec. Ak nie je nič vybraté, obe hodnoty označujú pozíciu kurzora.

Offsety počítajú jednotky kódu UTF-16, nie viditeľné znaky: niektoré emoji zaberajú dve jednotky. Pri textarea API používa hodnotu s normalizovanými koncami riadkov, nie nespracovaný text obsahujúci CR.

Priradenie zmení hranicu výberu, nie text. Web IDL najprv prevedie priradenú hodnotu na typ unsigned long. Ak hodnota po prevode presahuje dĺžku textu, obmedzí sa na túto dĺžku. Napríklad 2 ** 32 sa prevedie na 0, takže priradenie tejto hodnoty nastaví koniec na 0, nie na dĺžku textu v neprázdnom prvku textarea. Ak nový koniec leží pred selectionStart, na nový koniec sa posunie aj začiatok a výber sa zruší. Pomocou setSelectionRange(start, end) nastavíte obe hranice naraz.

Stav výberu existuje aj pri prvku, ktorý sa nezobrazuje, preto príklad ovládací prvok nepridáva do dokumentu. Ide o API prehliadača definované v HTML Standard, nie o funkciu jazyka ECMAScript; samotná prítomnosť Node 24 nepotvrdzuje jeho dostupnosť.

Príklady

const textarea = document.createElement('textarea');
textarea.value = 'Hello world';
textarea.setSelectionRange(0, 5);
console.log(textarea.selectionEnd);
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));
textarea.selectionEnd = 3;
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));

Výsledok

5
Hello
Hel

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje