La propriété en lecture seule validity de l'interface HTMLFieldSetElement retourne un objet ValidityState représentant les états de validité dans lesquels se trouve cet élément. Bien que les éléments HTML <fieldset> ne soient jamais candidats à la validation par contrainte, l'état de validité peut néanmoins être invalide si un message de validité personnalisé a été défini.

Note : Les pseudo-classes CSS :valid et :invalid sont appliquées aux éléments <fieldset> en fonction de la validité de leurs contrôles de formulaire enfants, et non du fieldset lui-même.

Valeur

Un objet ValidityState.

Exemples

L'exemple suivant montre qu'un <fieldset> est dans un état invalide lorsqu'un customError est défini ; dans cet état, checkValidity() renvoie true tandis que la propriété validity de validityState vaut false.

const fieldSet = document.getElementById("myFieldSet");
fieldSet.setCustomValidity("This fieldset is invalid.");
const validityState = fieldSet.validity;
console.log(validityState.valid); // false
console.log(validityState.customError); // true
console.log(fieldSet.checkValidity()); // true

Note : Les pseudo-classes CSS :valid et :invalid sont appliquées aux éléments <fieldset> en fonction de la validité de leurs contrôles de formulaire enfants, et non du fieldset lui-même.

Spécifications

Compatibilité des navigateurs

Voir aussi

• La méthode HTMLFieldSetElement.checkValidity()
• L'élément HTML <fieldset>
• L'élément HTML <form>
• Apprendre : Validation côté client des formulaires
• Guide : Validation par contrainte