CKTIS / HTML
onreset — formulierresets afhandelen
Het onreset-attribuut bevat JavaScript-code voor het afhandelen van het reset-event van een formulier. De handler wordt uitgevoerd voordat standaardwaarden worden hersteld en kan het resetten annuleren.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onreset="JavaScript code"onreset is een HTML-eventhandlerattribuut voor het reset-event. De waarde is JavaScript-code, geen eventnaam of Booleaanse waarde. Het attribuut staat meestal op een formulier; het event bubbelt omhoog, zodat ook een bovenliggend element het kan afhandelen.
Bij resetten via een knop met type="reset" of via form.reset() wordt eerst een annuleerbaar reset-event op het formulier afgevuurd. Pas daarna worden de besturingselementen teruggezet naar hun standaardtoestand — dat zijn niet noodzakelijk lege waarden. Tijdens de afhandeling kan de handler de waarden van vóór het resetten nog lezen.
In de attribuutcode verwijst event naar het event en this naar het element dat het afhandelt. event.preventDefault() of return false annuleert het resetten. Alleen return false stopt de propagatie niet.
Het attribuut onreset en de JavaScript-eigenschap form.onreset stellen dezelfde enkele handler in. Met form.addEventListener('reset', handler) kunnen meerdere handlers onafhankelijk van elkaar worden geregistreerd. CSP kan attribuutcode blokkeren; voor uitvoering van het voorbeeld moet die code zijn toegestaan.
Voorbeelden
<!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>Resultaat
during reset: Grace after reset: Ada
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.