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 = offsetHTMLTextAreaElement.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.