CKTIS / JavaScript
ValidityState.valid — algemene geldigheid van het besturingselement
ValidityState.valid is een alleen-lezen booleaanse eigenschap: de waarde is true wanneer geen van de validatiefoutvlaggen van het besturingselement is ingesteld.
Versie: 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, toegankelijk als element.validity.valid, is true wanneer alle andere foutvlaggen in ValidityState de waarde false hebben. Dit is een browser-API die is vastgelegd in de HTML Standard, geen functie van een bepaalde ECMAScript-editie.
Het object validity wordt voortdurend bijgewerkt. In het voorbeeld is het lege verplichte invoerveld ongeldig; door Ada in te voeren verdwijnt de fout voor de ontbrekende waarde. Een niet-leeg bericht in setCustomValidity() stelt een aangepaste fout in; setCustomValidity('') wist die.
Het lezen van valid toont geen bericht en veroorzaakt geen invalid. Het betekent ook niet dat het besturingselement aan validatie deelneemt: willValidate geeft aan of het daarvoor in aanmerking komt. checkValidity() houdt rekening met die geschiktheid, terwijl reportValidity() het probleem ook kan weergeven.
Voorbeelden
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);Resultaat
false true false true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.