Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLFieldSetElement : 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 HTMLFieldSetElement définit le message de validité personnalisé pour l'élément HTML <fieldset>. Utilisez la chaîne vide pour indiquer que l'élément n'a pas d'erreur de validité personnalisée.

L'élément <fieldset> n'est pas candidat à la validation par contrainte. La méthode reportValidity() ne provoquera pas l'affichage du message d'erreur personnalisé à l'utilisateur·ice, mais elle définit la propriété customError de l'objet ValidityState de l'élément à true et la propriété valid à false.

Syntaxe

js
setCustomValidity(string)

Paramètres

string

Une 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

js
const errorFieldSet = document.getElementById("checkErrors");
const errors = issuesToReport();
if (errors) {
  errorFieldSet.setCustomValidity("Une erreur est présente");
} else {
  errorFieldSet.setCustomValidity("");
}

Spécifications

Specification
HTML
# dom-cva-setcustomvalidity-dev

Compatibilité des navigateurs

Voir aussi