Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onchange — obsługa zdarzenia zmiany

Atrybut onchange zawiera kod JavaScript uruchamiany przy zdarzeniu change. W kontrolkach formularza oznacza ono zatwierdzoną zmianę użytkownika, a nie koniecznie każdą edycję wartości.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

onchange="JavaScript statements"

onchange jest atrybutem obsługi zdarzenia change. Jego wartość to treść funkcji JavaScript, a nie adres skryptu. Atrybut jest dostępny na wszystkich elementach HTML, ale samo jego dodanie nie sprawia, że element zaczyna generować change.

Moment wystąpienia zdarzenia zależy od kontrolki. Pole wyboru emituje change po przełączeniu przez użytkownika; pole tekstowe zwykle po zatwierdzeniu zmienionej wartości przez opuszczenie pola. input służy do reagowania na bieżące edycje. Samo przypisanie do .value lub .checked w JavaScript nie emituje automatycznie change.

W kodzie atrybutu this wskazuje element obsługujący zdarzenie, a event udostępnia obiekt zdarzenia. Odpowiednikiem w JavaScript jest właściwość element.onchange; kolejne przypisanie zastępuje poprzednią funkcję tego mechanizmu. element.addEventListener('change', handler) pozwala rejestrować niezależne procedury. Polityka Content Security Policy może blokować kod atrybutów, dlatego w takim środowisku należy użyć dozwolonego skryptu z addEventListener().

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onchange example</title>
<label>
  <input type="checkbox" onchange="document.getElementById('state').textContent = this.checked ? 'ON' : 'OFF'">
  Enabled
</label>
<p id="state" role="status">OFF</p>
</html>

Wynik

OFF → ON → OFF

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

Źródła