HTMLOutputElement: validity-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit August 2016 browserübergreifend verfügbar.
Die validity-Eigenschaft der HTMLOutputElement-Schnittstelle ist eine schreibgeschützte Eigenschaft, die ein ValidityState-Objekt zurückgibt. Dieses Objekt repräsentiert die Gültigkeitszustände, in denen sich dieses Element befindet. Obwohl <output>-Elemente niemals Kandidaten für die Einschränkungsvalidierung sind, kann der Gültigkeitszustand dennoch ungültig sein, wenn eine benutzerdefinierte Fehlermeldung festgelegt wurde.
Wert
Ein ValidityState-Objekt.
Beispiele
Das folgende Beispiel zeigt, dass ein <output> sich in einem ungültigen Zustand befindet, wenn ein customError festgelegt ist; in diesem Zustand gibt checkValidity() true zurück, während die validityState-Eigenschaft validity auf false steht.
const output = document.getElementById("myOutput");
output.setCustomValidity("This object element is invalid.");
const validityState = output.validity;
console.log(validityState.valid); // false
console.log(validityState.customError); // true
console.log(output.checkValidity()); // true
Spezifikationen
| Spezifikation |
|---|
| HTML # the-constraint-validation-api:dom-cva-validity |