Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
HTMLFormElement : méthode submit()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthodesubmit() de l'interfaceHTMLFormElement soumet l'élément HTML<form> fourni.
Cette méthode est similaire, mais pas identique, à l'activation du<button> de soumission d'un formulaire. Lorsqu'on appelle directement cette méthode, toutefois :
- Aucun évènement
submitn'est déclenché. En particulier, le gestionnaire d'évènementsonsubmitdu formulaire n'est pas exécuté. - Lavalidation des contraintes n'est pas déclenchée.
La méthodeHTMLFormElement.requestSubmit() est équivalente à l'activation du<button> de soumission du formulaire et ne présente pas ces différences.
Un contrôle de formulaire (par exemple un bouton de soumission) dont lename ouid estsubmit masquera la méthodesubmit du formulaire. Tenter d'appelermyForm.submit(); provoque une erreur « submit is not a function » parce que, dans ce cas,submit désigne le contrôle de formulaire qui a pourname ouid la valeursubmit.
Un<input> avec l'attributtype="submit" ne sera pas soumis avec le formulaire lorsque l'on utiliseHTMLFormElement.submit(), alors qu'il le serait lors d'une soumission via le formulaire HTML classique.
Syntaxe
submit()Paramètres
Aucun.
Valeur de retour
Aucun (undefined).
Exemples
document.forms["my-form"].submit();Spécifications
| Specification |
|---|
| HTML # dom-form-submit-dev |