Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onreset — obsługa resetowania formularza

Atrybut onreset zawiera kod JavaScript obsługujący zdarzenie reset formularza. Procedura działa przed przywróceniem wartości domyślnych i może anulować resetowanie.

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

Składnia

onreset="JavaScript code"

onreset to atrybut HTML obsługujący zdarzenie reset. Jego wartością jest kod JavaScript, nie nazwa zdarzenia ani wartość logiczna. Zwykle umieszcza się go na formularzu; zdarzenie bąbelkuje, więc może je również obsłużyć element nadrzędny.

Resetowanie wywołane przyciskiem type="reset" lub metodą form.reset() najpierw wysyła anulowalne zdarzenie reset do formularza. Dopiero potem przywraca stan domyślny kontrolek — niekoniecznie puste wartości. W trakcie obsługi nadal dostępne są wartości sprzed resetowania.

W kodzie atrybutu event oznacza zdarzenie, a this element obsługujący. event.preventDefault() lub return false anuluje resetowanie. Samo return false nie zatrzymuje propagacji.

Atrybut onreset i właściwość JavaScript form.onreset konfigurują tę samą pojedynczą procedurę obsługi. Alternatywą jest form.addEventListener('reset', handler), umożliwiające niezależne rejestrowanie wielu procedur. Polityka CSP może blokować kod atrybutu; przykład wymaga zezwolenia na jego wykonanie.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onreset example</title>
<form id="demo" onreset="document.getElementById('log').textContent += 'during reset: ' + this.elements.namedItem('nickname').value + '\n';">
  <label>Nickname <input name="nickname" value="Ada"></label>
  <button type="reset">Reset</button>
</form>
<pre id="log"></pre>
<script>
  const form = document.getElementById('demo');
  const field = form.elements.namedItem('nickname');
  field.value = 'Grace';
  form.reset();
  document.getElementById('log').textContent += 'after reset: ' + field.value;
</script>
</html>

Wynik

during reset: Grace
after reset: Ada

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

Źródła