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