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.