Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

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

Viri