HTMLTextAreaElement : méthode setCustomValidity() - Les API Web | MDN

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

js

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 :

js

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

Help improve MDN

Learn how to contribute

Cette page a été modifiée le par les contributeurs du MDN.