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

CKTIS / JavaScript

HTMLTextAreaElement.selectionStart — začetek izbora

HTMLTextAreaElement.selectionStart bere ali nastavi začetek izbora v elementu textarea. Odmik, štet od nič, šteje kodne enote UTF-16 in ne vidnih znakov.

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.selectionStart
textarea.selectionStart = offset

HTMLTextAreaElement.selectionStart je zapisljiva lastnost kontrolnika textarea. Skupaj z selectionEnd določa obseg: začetek je vključen, konec pa izključen. Če ni izbranega besedila, obe vrednosti označujeta položaj kazalke.

Odmiki štejejo kodne enote UTF-16 v value: 😀 zaseda dve. Ob prireditvi Web IDL vrednost najprej pretvori v 32-bitno nepredznačeno celo število. Položaj se omeji na konec besedila le, če pretvorjena vrednost presega dolžino besedila. Prireditev vrednosti 2 ** 32 na primer nastavi začetek na 0, saj je rezultat pretvorbe 0. Če je tako določeni začetek za dosedanjim koncem, se konec premakne na isti položaj in izbor se razveljavi.

To je brskalniški API iz HTML Standard, ne funkcija ECMAScript; sama različica Node.js ne dokazuje, da je podprt. Primer uporablja kontrolnik, ki ni vstavljen v dokument: njegovo stanje izbora je mogoče prebrati brez izrisovanja.

Primeri

const textarea = document.createElement('textarea');
textarea.value = 'A😀BC';
textarea.setSelectionRange(1, 3);
console.log(textarea.selectionStart, textarea.selectionEnd);
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));
textarea.selectionStart = 4;
console.log(textarea.selectionStart, textarea.selectionEnd);

Rezultat

1 3
😀
4 4

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri