HTMLFieldSetElement: validity-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since December 2018.

Die validity schreibgeschützte Eigenschaft des HTMLFieldSetElement-Interfaces gibt ein ValidityState-Objekt zurück, das die Gültigkeitszustände dieses Elements darstellt. Obwohl <fieldset>-Elemente niemals Kandidaten für die Eingabepflichtprüfung sind, kann der Gültigkeitszustand trotzdem ungültig sein, wenn eine benutzerdefinierte Gültigkeitsnachricht gesetzt wurde.

Hinweis: Die CSS-Pseudoklassen :valid und :invalid werden auf <fieldset>-Elemente angewendet, basierend auf der Gültigkeit ihrer untergeordneten Formularelemente, nicht auf das fieldset selbst.

Wert

Ein ValidityState-Objekt.

Beispiele

Das folgende Beispiel zeigt, dass ein <fieldset> in einem ungültigen Zustand ist, wenn ein customError gesetzt ist; in diesem Zustand gibt checkValidity() true zurück, während die validity-Eigenschaft von validityState false ist.

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

Hinweis: Die CSS-Pseudoklassen :valid und :invalid werden auf <fieldset>-Elemente angewendet, basierend auf der Gültigkeit ihrer untergeordneten Formularelemente, nicht auf das fieldset selbst.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch