Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources