HTMLSelectElement : 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 HTMLSelectElement retourne un booléen qui indique si l'élément satisfait aux règles de validation des contraintes qui lui sont appliquées. Si la valeur retournée 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.
Note :
Un élément HTML <select> dont la propriété validationMessage n'est pas une chaîne de caractères nulle est considéré comme non valide, correspond à la pseudo-classe CSS :invalid, et provoque le retour de la valeur équivalente à faux par checkValidity(). Utilisez la méthode HTMLSelectElement.setCustomValidity() pour définir la propriété HTMLSelectElement.validationMessage sur une chaîne de caractères 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("mySelect");
console.log(element.checkValidity());
Spécifications
| Specification |
|---|
| HTML # dom-cva-checkvalidity-dev |
Compatibilité des navigateurs
Voir aussi
- La méthode
HTMLSelectElement.reportValidity() - L'élément HTML
<textarea> - L'élément HTML
<form> - Apprendre : Validation de formulaire côté client
- Guide : Validation des contraintes
- Les pseudo-classes CSS
:validet:invalid