HTMLFieldSetElement: validity-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die schreibgeschützte validity-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 Einschränkungsvalidierung sind, kann der Gültigkeitszustand dennoch ungültig sein, wenn eine benutzerdefinierte Gültigkeitsmeldung festgelegt wurde.
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 valid-Eigenschaft von validityState false ist.
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
Spezifikationen
| Spezifikation |
|---|
| HTML # the-constraint-validation-api:dom-cva-validity |