Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLTextAreaElement.selectionStart — początek zaznaczenia

HTMLTextAreaElement.selectionStart odczytuje lub ustawia początek zaznaczenia w textarea. Pozycja jest liczona od zera w jednostkach UTF-16, a nie w widocznych znakach.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

textarea.selectionStart
textarea.selectionStart = offset

HTMLTextAreaElement.selectionStart jest zapisywalną właściwością kontrolki textarea. Wraz z selectionEnd wyznacza zakres: początek jest włączony, koniec wyłączony. Bez zaznaczenia obie wartości wskazują kursor.

Indeksy dotyczą jednostek UTF-16 w value: 😀 zajmuje dwie. Przy przypisaniu Web IDL najpierw konwertuje wartość na 32-bitową liczbę całkowitą bez znaku. Dopiero jeśli wynik konwersji przekracza długość tekstu, pozycja zostaje ograniczona do jego końca. Na przykład przypisanie 2 ** 32 ustawia początek na 0, ponieważ taki jest wynik konwersji. Jeśli tak wyznaczony początek wypada za dotychczasowym końcem, koniec przesuwa się na tę samą pozycję, zwijając zaznaczenie.

To API przeglądarki z HTML Standard, nie funkcja ECMAScript; sama wersja Node.js nie dowodzi obsługi. Przykład używa odłączonej kontrolki: jej stan zaznaczenia można odczytywać bez renderowania.

Przykłady

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);

Wynik

1 3
😀
4 4

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła