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