CKTIS / JavaScript
HTMLTextAreaElement.selectionEnd — konec výběru
HTMLTextAreaElement.selectionEnd umožňuje přečíst nebo nastavit koncovou hranici výběru v prvku textarea. Jde o offset počítaný od nuly v jednotkách kódu UTF-16; koncová pozice do výběru nepatří.
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.selectionEnd
textarea.selectionEnd = endHTMLTextAreaElement.selectionEnd je vlastnost pro čtení i zápis. Určuje pozici bezprostředně za vybraným textem v textarea.value. selectionStart a selectionEnd popisují zahrnutý začátek a nezahrnutý konec. Pokud není nic vybráno, obě hodnoty označují pozici kurzoru.
Offsety počítají jednotky kódu UTF-16, nikoli viditelné znaky: některé emoji zabírají dvě jednotky. U textarea API používá hodnotu s normalizovanými konci řádků, nikoli nezpracovaný text obsahující CR.
Přiřazení změní hranici výběru, nikoli text. Web IDL nejprve převede přiřazenou hodnotu na typ unsigned long. Pokud hodnota po převodu překračuje délku textu, omezí se na tuto délku. Například 2 ** 32 se převede na 0, takže přiřazení této hodnoty nastaví konec na 0, nikoli na délku textu v neprázdném prvku textarea. Pokud nový konec leží před selectionStart, posune se na nový konec i začátek a výběr se zruší. Pomocí setSelectionRange(start, end) nastavíte obě hranice najednou.
Stav výběru existuje i u prvku, který se nevykresluje, proto příklad ovládací prvek nepřidává do dokumentu. Jde o API prohlížeče definované v HTML Standard, nikoli o funkci jazyka ECMAScript; samotná přítomnost Node 24 nepotvrzuje jeho dostupnost.
Pří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ýsledek
5 Hello Hel
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.