KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLInputElement.validity — geldigheidsstatus van een invoerveld

HTMLInputElement.validity geeft de huidige status van de beperkingsvalidatie van een invoerveld weer als een ValidityState-object. De vlaggen geven specifieke problemen aan; valid laat zien of er geen foutvlag 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

input.validity
input.validity.valid
input.validity.valueMissing

HTMLInputElement.validity is een alleen-lezen-eigenschap die een live ValidityState-object retourneert: een bewaarde verwijzing weerspiegelt latere wijzigingen aan het invoerveld. De vlaggen zijn ook alleen-lezen. Deze browser-API is gedefinieerd door HTML, niet door ECMAScript; de beschikbaarheid van Node.js alleen biedt geen garantie op ondersteuning.

valueMissing geeft aan dat een verplichte waarde ontbreekt, typeMismatch dat de indeling niet bij het type past en patternMismatch dat de waarde niet overeenkomt met pattern. De overige foutvlaggen zijn tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput en customError. Of ze van toepassing zijn, hangt af van het invoertype en de beperkingen. valid is true wanneer alle foutvlaggen false zijn.

Het uitlezen van validity toont geen melding en activeert geen invalid. checkValidity() controleert het element en kan invalid activeren; reportValidity() kan het probleem ook aan de gebruiker tonen. willValidate bepaalt of het element aan de validatie deelneemt: een uitgeschakeld invoerveld kan nog steeds foutvlaggen hebben, hoewel het niet aan de controle deelneemt.

setCustomValidity('Blocked') stelt customError in; wis deze met setCustomValidity(''). Alleen de waarde corrigeren wist de fout niet. Het voorbeeld laat zien hoe wijzigingen zichtbaar worden via het bewaarde object state, zonder input.validity opnieuw uit te lezen. Browservalidatie vervangt controles van gegevens aan de serverzijde niet.

Voorbeelden

const input = document.createElement('input');
input.type = 'email';
input.required = true;
const state = input.validity;

console.log(state.valueMissing, state.valid);
input.value = 'learner@example.com';
console.log(state.valueMissing, state.valid);
input.setCustomValidity('Blocked');
console.log(state.customError, state.valid);
input.setCustomValidity('');
console.log(state.customError, state.valid);

Resultaat

true false
false true
true false
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.

Bronnen