HTMLTextAreaElement : méthode setCustomValidity()

Baseline Large disponibilité

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.

Dans cet article

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 :

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("");
}