HTMLTextAreaElement : 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 HTMLTextAreaElement retourne une valeur booléenne qui indique si l'élément respecte les règles de validation de contrainte qui lui sont appliquées. Si équivalent à faux, la méthode déclenche aussi un évènement invalid sur l'élément. Comme il n'y a pas de comportement par défaut du navigateur pour checkValidity(), annuler cet évènement invalid n'a aucun effet.
Note :
Un élément HTML <textarea> avec une validationMessage non nulle est considéré comme non valide, correspondra à la pseudo-classe CSS :invalid et fera que checkValidity() retourne équivalent à faux. Utilisez la méthode HTMLTextAreaElement.setCustomValidity() pour définir la HTMLTextAreaElement.validationMessage sur une 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 équivalent à vrai, soit équivalent à faux.
const element = document.getElementById("myTextArea");
console.log(element.checkValidity());
Spécifications
| Specification |
|---|
| HTML # dom-cva-checkvalidity-dev |
Compatibilité des navigateurs
Voir aussi
- La méthode
HTMLTextAreaElement.reportValidity() - Les éléments HTML
<textarea> - Les éléments HTML
<form> - Apprendre : Validation de formulaire côté client
- Guide : Validation de contrainte
- Les pseudos-classes CSS
:validet:invalid