Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLTextAreaElement.selectionEnd — koniec zaznaczenia

HTMLTextAreaElement.selectionEnd pozwala odczytać lub ustawić końcową granicę zaznaczenia w textarea. Jest to indeks liczony od zera w jednostkach kodowych UTF-16; pozycja końcowa nie należy do zaznaczenia.

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.selectionEnd
textarea.selectionEnd = end

HTMLTextAreaElement.selectionEnd to właściwość do odczytu i zapisu. Wskazuje pozycję tuż za zaznaczonym tekstem w textarea.value. Zakres opisują selectionStart i selectionEnd: początek jest włączony, koniec wyłączony. Gdy nie ma zaznaczenia, obie wartości oznaczają pozycję kursora.

Indeksy liczy się w jednostkach kodowych UTF-16, nie w widocznych znakach: niektóre emoji zajmują dwie jednostki. Dla textarea używana jest wartość API ze znormalizowanymi zakończeniami wierszy, a nie surowy tekst zawierający CR.

Przypisanie zmienia granicę zaznaczenia, nie treść. Web IDL najpierw konwertuje przypisywaną wartość na typ unsigned long. Dopiero jeśli wynik konwersji przekracza długość tekstu, zostaje ograniczony do tej długości. Na przykład 2 ** 32 po konwersji daje 0, więc takie przypisanie ustawia koniec zaznaczenia na 0, a nie na długość tekstu w niepustym polu textarea. Jeśli nowy koniec wypada przed selectionStart, początek również przesuwa się do nowego końca, zwijając zaznaczenie. Do jednoczesnego ustawienia obu granic służy setSelectionRange(start, end).

Stan zaznaczenia istnieje nawet dla niewyświetlanego elementu, dlatego przykład nie dodaje kontrolki do dokumentu. To API przeglądarki z HTML Standard, nie funkcja samego ECMAScript; obecność Node 24 nie potwierdza jego dostępności.

Przykłady

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

Wynik

5
Hello
Hel

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

Źródła