CKTIS / JavaScript
HTMLTextAreaElement.selectionEnd — kraj odabira
HTMLTextAreaElement.selectionEnd omogućuje čitanje ili postavljanje završne granice odabira u elementu textarea. Riječ je o odmaku koji počinje od nule i mjeri se u UTF-16 kodnim jedinicama; završni položaj nije dio odabira.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
textarea.selectionEnd
textarea.selectionEnd = endHTMLTextAreaElement.selectionEnd svojstvo je za čitanje i pisanje. Označava položaj neposredno nakon odabranog teksta u textarea.value. selectionStart i selectionEnd opisuju uključeni početak i isključeni kraj. Ako nema odabira, obje vrijednosti označavaju položaj pokazivača.
Odmaci broje UTF-16 kodne jedinice, a ne vidljive znakove: neki emojiji zauzimaju dvije jedinice. Za textarea API upotrebljava vrijednost s normaliziranim završecima redaka, a ne sirovi tekst koji sadrži CR.
Dodjela mijenja granicu odabira, a ne tekst. Web IDL najprije pretvara dodijeljenu vrijednost u tip unsigned long. Ako pretvorena vrijednost premašuje duljinu teksta, ograničava se na tu duljinu. Primjerice, 2 ** 32 pretvara se u 0, pa dodjela te vrijednosti postavlja kraj na 0, a ne na duljinu teksta u nepraznom elementu textarea. Ako je novi kraj prije selectionStart, i početak se pomiče na novi kraj pa se odabir poništava. Upotrijebite setSelectionRange(start, end) za istodobno postavljanje obiju granica.
Stanje odabira postoji i za element koji nije prikazan, pa primjer ne dodaje kontrolu u dokument. Ovo je API preglednika definiran u HTML Standardu, a ne značajka jezika ECMAScript; postojanje Nodea 24 ne potvrđuje njegovu dostupnost.
Primjeri
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));Rezultat
5 Hello Hel
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.