CKTIS / HTML
onreset — gérer la réinitialisation des formulaires
L’attribut onreset contient du code JavaScript qui gère l’événement reset d’un formulaire. Le gestionnaire s’exécute avant le rétablissement des valeurs par défaut et peut annuler la réinitialisation.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onreset="JavaScript code"onreset est un attribut HTML de gestionnaire d’événement pour l’événement reset. Sa valeur est du code JavaScript, et non un nom d’événement ou une valeur booléenne. Il se place généralement sur un formulaire ; l’événement remonte dans la hiérarchie, donc un élément ancêtre peut aussi le gérer.
Une réinitialisation déclenchée par un bouton type="reset" ou par form.reset() commence par envoyer au formulaire un événement reset annulable. Ce n’est qu’ensuite que les contrôles retrouvent leur état par défaut — qui ne correspond pas nécessairement à des valeurs vides. Pendant le traitement, le gestionnaire peut encore lire les valeurs antérieures à la réinitialisation.
Dans le code de l’attribut, event désigne l’événement et this l’élément qui gère l’événement. event.preventDefault() ou return false annule la réinitialisation. À lui seul, return false n’arrête pas la propagation.
L’attribut onreset et la propriété JavaScript form.onreset configurent le même gestionnaire unique. Autre possibilité : form.addEventListener('reset', handler) permet d’enregistrer plusieurs gestionnaires indépendamment. Une politique CSP peut bloquer le code de l’attribut ; l’exemple nécessite que son exécution soit autorisée.
Exemples
<!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>Résultat
during reset: Grace after reset: Ada
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.