HTMLTextAreaElement : méthode setCustomValidity()
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 setCustomValidity() de l'interface HTMLTextAreaElement définit le message de validité personnalisé pour l'élément HTML <textarea>. Utilisez la chaîne de caractères vide pour indiquer que l'élément n'a pas d'erreur de validité personnalisée.
Syntaxe
setCustomValidity(string)
Paramètres
string-
La chaîne de caractères contenant le message d'erreur. La chaîne de caractères vide retire toute erreur de validité personnalisée.
Valeur retournée
Aucune (undefined).
Exemples
Dans cet exemple, si le <textarea> ne passe pas la validation des contraintes, nous fournissons des erreurs personnalisées selon la contrainte qui échoue. Si la valeur est valide, nous définissons l'erreur personnalisée sur une chaîne de caractères vide :
const comment = document.getElementById("comment");
if (comment.validity.valueMissing) {
comment.setCustomValidity(
"Nous ne pouvons pas envoyer un commentaire vide !",
);
} else if (comment.validity.tooShort) {
comment.setCustomValidity(
"Dites-nous en plus ! Votre commentaire est trop court.",
);
} else if (comment.validity.tooLong) {
comment.setCustomValidity(
"Vous êtes bien bavard·e ! Limitez-vous à moins de 800 caractères !",
);
} else {
comment.setCustomValidity("");
}
Spécifications
| Specification |
|---|
| HTML # dom-cva-setcustomvalidity-dev |
Compatibilité des navigateurs
Voir aussi
- L'élément HTML
<textarea> - L'interface
HTMLTextAreaElement - La propriété
HTMLTextAreaElement.validity - La méthode
HTMLTextAreaElement.checkValidity() - La méthode
HTMLTextAreaElement.reportValidity() - Validation de formulaire.
- Apprendre : Validation de formulaire côté client
- Guide : Validation des contraintes
- Les pseudo-classes CSS
:validet:invalid