CKTIS / JavaScript
HTMLInputElement.validity — stanje valjanosti polja za unos
HTMLInputElement.validity izlaže trenutačno stanje provjere ograničenja polja za unos kao objekt ValidityState. Njegove zastavice označavaju određene probleme, dok valid pokazuje jesu li sve zastavice pogrešaka nepostavljene.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
input.validity
input.validity.valid
input.validity.valueMissingHTMLInputElement.validity svojstvo je samo za čitanje koje vraća živi objekt ValidityState: spremljena referenca odražava kasnije promjene polja za unos. I njegove su zastavice samo za čitanje. Ovaj API preglednika definira HTML, a ne ECMAScript; sama dostupnost Node.js-a ne jamči njegovu podršku.
valueMissing označava da nedostaje obvezna vrijednost, typeMismatch format koji ne odgovara vrsti, a patternMismatch nepodudaranje s pattern. Ostale zastavice pogrešaka su tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput i customError. Njihova primjenjivost ovisi o vrsti polja i ograničenjima. valid ima vrijednost true kada sve zastavice pogrešaka imaju vrijednost false.
Čitanje svojstva validity ne prikazuje poruku niti pokreće invalid. checkValidity() provjerava kontrolu i može pokrenuti invalid; reportValidity() može dodatno prikazati problem korisniku. willValidate određuje sudjelovanje u provjeri: onemogućeno polje za unos i dalje može imati zastavice pogrešaka iako ne sudjeluje u provjeri.
setCustomValidity('Blocked') postavlja customError; izbrišite ga pomoću setCustomValidity(''). Sama ispravka vrijednosti ne uklanja pogrešku. Primjer prikazuje ažuriranja putem spremljenog objekta state, bez ponovnog čitanja input.validity. Provjera u pregledniku ne zamjenjuje provjeru podataka na poslužitelju.
Primjeri
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);Rezultat
true false false true true false false true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.