CKTIS / JavaScript
ValidityState — stanje provjere valjanosti polja obrasca
ValidityState izlaže zastavice pogrešaka polja obrasca samo za čitanje. Omogućuje razlikovanje nedostajuće obavezne vrijednosti, neispravnog formata i prekratkog teksta, uz važnu iznimku za vrijednosti koje postavljaju skripte.
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
const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;ValidityState je sučelje HTML Web API-ja, a ne dio ECMAScripta. Objekt dostupan putem input.validity ažurira se u stvarnom vremenu; njegove Booleove zastavice samo su za čitanje. ValidityState.valid ima vrijednost true kada nije postavljena nijedna od ostalih zastavica pogreške.
ValidityState.valueMissing označava da ograničenje required nije ispunjeno: u tekstualnom polju to znači da je vrijednost prazna. ValidityState.typeMismatch znači da vrijednost ne odgovara pravilima vrste email ili url, a ne vrsti podataka JavaScripta. Prazna adresa e-pošte sama po sebi ne uzrokuje tu pogrešku.
ValidityState.tooShort odnosi se na nepraznu vrijednost kraću od minlength u polju koje podržava to ograničenje. Zastavica dirty value mora biti postavljena, a posljednju promjenu vrijednosti morao je napraviti korisnik. Dodjela vrijednosti u .value ne pokreće tu provjeru duljine; sam minlength ne zahtijeva unos vrijednosti.
Primjer zadržava jedan objekt stanja i čita ga nakon promjena. Za 'x' tooShort ostaje false jer vrijednost postavlja skripta. Pokrenite ga u pregledniku; prisutnost Nodea 24 u repozitoriju ne dokazuje podršku za ovaj API.
Primjeri
(() => {
const input = document.createElement('input');
input.type = 'email';
input.required = true;
input.minLength = 8;
const state = input.validity;
const show = () => console.log(JSON.stringify({
valid: state.valid,
valueMissing: state.valueMissing,
typeMismatch: state.typeMismatch,
tooShort: state.tooShort
}));
show();
input.value = 'x';
show();
input.value = 'a@example.com';
show();
})();Rezultat
{"valid":false,"valueMissing":true,"typeMismatch":false,"tooShort":false}
{"valid":false,"valueMissing":false,"typeMismatch":true,"tooShort":false}
{"valid":true,"valueMissing":false,"typeMismatch":false,"tooShort":false}Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.