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