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éthode checkValidity() de l'interface HTMLButtonElement retourne une valeur booléenne qui indique si l'élément satisfait toutes les règles de validation de contraintes qui lui sont appliquées. Si la valeur est équivalente à faux, la méthode déclenche également un événement invalid sur l'élément. Comme il n'existe pas de comportement par défaut du navigateur pour checkValidity(), annuler cet événement invalid 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 à la validation de contraintes.
Note :
Un élément HTML <button> de type "submit" avec une validationMessage non nulle est considéré comme non valide, correspondra à la pseudo-classe CSS :invalid et fera que checkValidity() retourne faux. Utilisez la méthode HTMLButtonElement.setCustomValidity() pour définir le HTMLButtonElement.validationMessage à la chaîne vide afin de rendre l'état validity valide.
Syntaxe
checkValidity()
Paramètres
Aucun.
Valeur de retour
Retourne true si la valeur de l'élément ne présente aucun problème de validité ; sinon, retourne false.
Exemples
Dans l'exemple suivant, l'appel à checkValidity() retourne soit true, soit false.
const element = document.getElementById("myButton");
console.log(element.checkValidity());
Spécifications
| Specification |
|---|
| HTML # dom-cva-checkvalidity-dev |