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 : propriété validity

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 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.

js
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

Specification
HTML
# the-constraint-validation-api:dom-cva-validity

Compatibilité des navigateurs

Voir aussi