Attribut global HTMLAttributs globaux

onsubmit

Exécute du code JavaScript juste avant l’envoi d’un formulaire. Permet d’arrêter l’envoi et de traiter les données dans un script.

S’applique à
<form>
Sur cette page

Exemple

#
HTML
<form onsubmit="
  event.preventDefault();
  const email = this.elements.email.value;
  this.hidden = true;
  document.getElementById('thanks').textContent =
    'Merci ! Nous avons envoyé le lien vers la première leçon à ' + email + '.';
">
  <label for="email">E-mail</label>
  <input type="email" id="email" name="email" placeholder="anne@example.com" required>
  <button>S’abonner à la newsletter</button>
</form>
<p id="thanks"></p>
Aperçu

Essayez d’abord d’envoyer le formulaire vide : le navigateur affiche une erreur de validation et le code de onsubmit ne s’exécute pas. Après la saisie d’une adresse valide, le formulaire disparaît et un remerciement apparaît.

Définition et utilisation

#

Vous placez l’attribut onsubmit sur un élément <form>. L’événement submit se produit lorsque l’utilisateur envoie le formulaire : clique sur le bouton d’envoi ou appuie sur Entrée dans un champ de texte. Auparavant, le navigateur vérifie les règles de validation, comme required ou type="email", et si un champ est invalide, l’événement ne se produit pas du tout.

On y appelle le plus souvent event.preventDefault(). Cela arrête l’envoi ordinaire et le rechargement de la page, ce qui vous permet d’envoyer les données vous-même, par exemple avec fetch(), et d’afficher le résultat sans quitter la page. Dans l’attribut, return false donne le même effet.

Dans le code de l’attribut, this désigne le formulaire. Vous lisez les champs via this.elements, et toutes les valeurs d’un coup avec new FormData(this). N’oubliez pas que la méthode form.submit() appelée dans un script envoie le formulaire sans événement submit et sans validation. Si vous voulez que les deux fonctionnent, utilisez form.requestSubmit(). Dans des projets plus importants, ajoutez la gestion avec addEventListener("submit", …).

Syntaxe

#
Syntaxe
<form onsubmit="code JavaScript">…</form>

Disponible dans le code de l’attribut

#
  • event.preventDefault()

    Arrête l’envoi ordinaire du formulaire et le rechargement de la page.
  • return false

    Un raccourci qui ne fonctionne que dans un attribut. Il donne le même effet que event.preventDefault().
  • this.elements

    Les champs du formulaire. Le champ avec name="email" se lit this.elements.email.value.
  • new FormData(this)

    Les valeurs de tous les champs ayant un attribut name, prêtes à être envoyées avec fetch().
  • event.submitter

    Le bouton qui a envoyé le formulaire. Utile lorsque le formulaire a plusieurs boutons, par exemple « Enregistrer le brouillon » et « Publier ».

Plus d’exemples

#
Gestion de l’envoi avec addEventListener et FormData
HTML
<form id="signup">
  <label>Prénom <input name="name" required></label>
  <label>Formation
    <select name="course">
      <option>HTML et CSS</option>
      <option>JavaScript</option>
      <option>Python</option>
    </select>
  </label>
  <button>Inscrivez-moi</button>
</form>
<p id="result"></p>

<script>
  document.getElementById('signup').addEventListener('submit', (event) => {
    event.preventDefault();
    const data = new FormData(event.currentTarget);
    document.getElementById('result').textContent =
      data.get('name') + ', nous vous avons inscrit à la formation ' + data.get('course') + '.';
  });
</script>
Aperçu

Dans une vraie application, les données iraient vers un serveur, par exemple via fetch("/api/zapisy", { method: "POST", body: data }), et non dans un paragraphe de la page.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Gérez l’envoi avec l’événement submit sur le formulaire, et non avec le clic sur un bouton. submit capte aussi l’envoi avec la touche Entrée et ne s’exécute qu’après une validation réussie.
  • Après event.preventDefault(), le retour d’information vous incombe : montrez que les données sont en cours d’envoi, bloquez le bouton contre le double clic et affichez le résultat ou l’erreur.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.