HTMLOutputElement : méthode setCustomValidity()

La méthode setCustomValidity() de l'interface HTMLOutputElement définit le message de validité personnalisé pour l'élément HTML <output>. Utilisez la chaîne vide pour indiquer que l'élément n'a pas d'erreur de validité personnalisée.

L'élément <output> n'est pas candidat à la validation de contraintes. La méthode reportValidity() n'affichera pas le message d'erreur personnalisé à l'utilisateur·ice, mais définira la propriété customError de l'objet ValidityState de l'élément à true et la propriété valid à false.

Syntaxe

setCustomValidity(string)

Paramètres

string

La chaîne de caractères contenant le message d'erreur. La chaîne vide supprime toute erreur de validité personnalisée.

Valeur de retour

Aucune (undefined).

Exemples

Dans cet exemple, si la valeur (value) de <output> n'est pas un nombre non nul, on définit un message d'erreur personnalisé. Si c'est un nombre, on définit l'erreur personnalisée à une chaîne vide :

const cart = document.getElementById("cart-form");
const total = cart.elements("total");
if (parseFloat(total.value)) {
 errorOutput.setCustomValidity("");
} else {
 errorOutput.setCustomValidity("Il y a une erreur");
}

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'élément HTML <output>
• L'interface HTMLOutputElement
• La propriété HTMLOutputElement.validity
• La méthode HTMLOutputElement.checkValidity()
• La méthode HTMLOutputElement.reportValidity()
• Validation de formulaire.
• Apprendre : Validation de formulaire côté client
• Guide : Validation de contraintes
• Les pseudo-classes CSS :valid et :invalid