CKTIS / JavaScript
HTMLTextAreaElement.selectionEnd — konec izbora
HTMLTextAreaElement.selectionEnd omogoča branje ali nastavitev končne meje izbora v elementu textarea. Gre za odmik od ničle, merjen v kodnih enotah UTF-16; končni položaj ni vključen v izbor.
Različica: 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 je lastnost za branje in pisanje. Označuje položaj neposredno za izbranim besedilom v textarea.value. selectionStart in selectionEnd določata vključeni začetek in izključeni konec. Če ni izbranega besedila, obe vrednosti označujeta položaj kazalke.
Odmiki štejejo kodne enote UTF-16, ne vidnih znakov: nekateri emojiji zasedajo dve enoti. Pri textarea API uporablja vrednost z normaliziranimi konci vrstic, ne surovega besedila, ki vsebuje CR.
Dodelitev spremeni mejo izbora, ne besedila. Web IDL dodeljeno vrednost najprej pretvori v tip unsigned long. Če pretvorjena vrednost presega dolžino besedila, se omeji na to dolžino. Vrednost 2 ** 32 se na primer pretvori v 0, zato dodelitev te vrednosti nastavi konec na 0, ne na dolžino besedila v nepraznem elementu textarea. Če je novi konec pred selectionStart, se tudi začetek premakne na novi konec in izbor se razveljavi. Z setSelectionRange(start, end) nastavite obe meji hkrati.
Stanje izbora obstaja tudi pri elementu, ki ni prikazan, zato primer kontrolnika ne doda v dokument. To je API brskalnika, določen v HTML Standard, in ne funkcija jezika ECMAScript; prisotnost Node 24 ne potrjuje njegove razpoložljivosti.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.