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-Eigenschaft der HTMLFieldSetElement-Schnittstelle, die nur lesbar ist, gibt ein ValidityState-Objekt zurück, das die Zustände der Gültigkeit dieses Elements darstellt. Obwohl <fieldset>-Elemente niemals Kandidaten für die Constraints-Validierung sind, kann der Gültigkeitszustand dennoch ungültig sein, wenn eine benutzerdefinierte Fehlermeldung festgelegt wurde.

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

Wert

Ein ValidityState-Objekt.

Beispiele

Das folgende Beispiel zeigt, dass ein <fieldset> sich in einem ungültigen Zustand befindet, wenn ein customError gesetzt ist; in diesem Zustand gibt checkValidity() true zurück, während die validityState-Eigenschaft 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 :valid und :invalid CSS-Pseudoklassen werden auf <fieldset>-Elemente basierend auf der Gültigkeit ihrer nachgeordneten Formularelemente angewendet, 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