Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
HTMLButtonElement : méthode checkValidity()
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éthodecheckValidity() de l'interfaceHTMLButtonElement retourne une valeur booléenne qui indique si l'élément satisfait toutes les règles devalidation de contraintes qui lui sont appliquées. Si la valeur est équivalente à faux, la méthode déclenche également un événementinvalid sur l'élément. Comme il n'existe pas de comportement par défaut du navigateur pourcheckValidity(), annuler cet événementinvalid n'a aucun effet. Cette méthode retourne toujours vrai si la propriététype de l'élément<button> vaut"button" ou"reset", car ces boutons ne sont jamais candidats à lavalidation de contraintes.
Note :Un élément HTML<button> de type"submit" avec unevalidationMessage non nulle est considéré comme non valide, correspondra à la pseudo-classe CSS:invalid et fera quecheckValidity() retourne faux. Utilisez la méthodeHTMLButtonElement.setCustomValidity() pour définir leHTMLButtonElement.validationMessage à la chaîne vide afin de rendre l'étatvalidity valide.
Syntaxe
checkValidity()Paramètres
Aucun.
Valeur de retour
Retournetrue si la valeur de l'élément ne présente aucun problème de validité ; sinon, retournefalse.
Exemples
Dans l'exemple suivant, l'appel àcheckValidity() retourne soittrue, soitfalse.
const element = document.getElementById("myButton");console.log(element.checkValidity());Spécifications
| Specification |
|---|
| HTML # dom-cva-checkvalidity-dev |