CKTIS / JavaScript
ValidityState.valid — zusammengefasster Gültigkeitsstatus eines Steuerelements
ValidityState.valid ist eine schreibgeschützte boolesche Eigenschaft: Sie ist true, wenn keine der Validierungsfehler-Flags des Steuerelements gesetzt ist.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.validity.validValidityState.valid, abrufbar als element.validity.valid, ist true, wenn alle anderen Fehler-Flags in ValidityState den Wert false haben. Dies ist eine Browser-API, die im HTML Standard definiert ist, und kein Feature einer bestimmten ECMAScript-Version.
Das Objekt validity wird laufend aktualisiert. Im Beispiel ist das leere Pflichtfeld ungültig; durch die Eingabe von Ada wird der Fehler wegen des fehlenden Werts beseitigt. Eine nicht leere Nachricht in setCustomValidity() setzt einen benutzerdefinierten Fehler; setCustomValidity('') entfernt ihn.
Das Lesen von valid zeigt weder eine Meldung an noch löst es invalid aus. Es bedeutet auch nicht, dass das Steuerelement an der Validierung teilnimmt: willValidate gibt an, ob es dafür infrage kommt. checkValidity() berücksichtigt diese Teilnahmeberechtigung, während reportValidity() das Problem zusätzlich anzeigen kann.
Beispiele
const input = document.createElement('input');
input.required = true;
const state = input.validity;
console.log(state.valid);
input.value = 'Ada';
console.log(state.valid);
input.setCustomValidity('Rejected');
console.log(state.valid);
input.setCustomValidity('');
console.log(state.valid);Ergebnis
false true false true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.