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>
Exemple
#<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>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
#<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 queevent.preventDefault().this.elements
Les champs du formulaire. Le champ avecname="email"se litthis.elements.email.value.new FormData(this)
Les valeurs de tous les champs ayant un attributname, prêtes à être envoyées avecfetch().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
#<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>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
submitsur le formulaire, et non avec le clic sur un bouton.submitcapte 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
#- <form>Un formulaire qui collecte des données auprès de l’utilisateur et les envoie à une adresse donnée.
- <button>Un bouton cliquable : il envoie un formulaire, le réinitialise, ou lance une action sur la page.
- <input>Un champ de formulaire : texte, e-mail, mot de passe, nombre, date, curseur, case à cocher, fichier et bien plus encore.
- onchangeExécute du code JavaScript lorsque l’utilisateur valide une nouvelle valeur du champ : choisit une option, coche une case ou termine sa saisie.
- onclickExécute du code JavaScript au clic sur l’élément. La façon la plus simple, mais pas la meilleure, de gérer les événements.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.