CKTIS / HTML
onselect — obsługa zaznaczania tekstu
Atrybut onselect definiuje kod JavaScript uruchamiany po zdarzeniu select, zwykle związanym z zaznaczeniem tekstu w polu input lub textarea. Nie służy do wykrywania wyboru opcji w elemencie select.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
onselect="JavaScript statements"
element.onselect = function (event) { /* handler */ }onselect to atrybut obsługi zdarzenia select. Jest dostępny na wszystkich elementach HTML, ale samo jego dodanie nie sprawia, że element zaczyna generować takie zdarzenia. Typowym zastosowaniem jest reagowanie na zaznaczenie tekstu w obsługujących je polach input oraz w textarea; zaznaczenie może też zostać zmienione programowo.
Wartością atrybutu jest kod JavaScript, a nie wartość logiczna ani sama nazwa funkcji. W kodzie wpisanym w atrybut event oznacza zdarzenie, a this wskazuje element obsługujący zdarzenie. Granice zaznaczenia można odczytać przez selectionStart i selectionEnd; drugi indeks nie należy do zaznaczonego fragmentu.
Odpowiadająca atrybutowi właściwość JavaScript element.onselect przyjmuje funkcję; przypisanie kolejnej zastępuje poprzednią obsługę w tym miejscu. Alternatywą jest addEventListener('select', handler). Nie myl zdarzenia select z elementem select: do reagowania na zmianę wybranej opcji służą input lub change.
Przykład ustawia zakres od indeksu 1 do 5 w tekście Hello. Po obsłużeniu zdarzenia wynik to Selected: ello. Kod wymaga włączonego JavaScript i możliwości wykonywania obsługi zapisanej w atrybutach; polityka Content Security Policy może ją blokować.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>onselect demo</title>
<label>Text: <input id="text" type="text" value="Hello" onselect="document.getElementById('result').textContent = this.value.slice(this.selectionStart, this.selectionEnd)"></label>
<p>Selected: <output id="result"></output></p>
<script>
document.getElementById('text').setSelectionRange(1, 5);
</script>Wynik
Selected: ello
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.