HTMLOutputElement : 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 août 2016.
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
| Specification |
|---|
| HTML # dom-cva-setcustomvalidity-dev |
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
:validet:invalid