CKTIS / JavaScript
ValidityState — stav validácie poľa formulára
ValidityState sprístupňuje príznaky chýb poľa formulára iba na čítanie. Umožňuje rozlíšiť chýbajúcu povinnú hodnotu, neplatný formát a príliš krátky text, s dôležitou výnimkou pre hodnoty nastavené skriptom.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;ValidityState je rozhranie HTML Web API, nie súčasť ECMAScriptu. Objekt dostupný cez input.validity sa priebežne aktualizuje; jeho booleovské príznaky sú iba na čítanie. ValidityState.valid má hodnotu true, keď nie je nastavený žiadny z ostatných príznakov chyby.
ValidityState.valueMissing signalizuje nesplnenie obmedzenia required: pri textovom poli to znamená prázdnu hodnotu. ValidityState.typeMismatch znamená, že hodnota nezodpovedá pravidlám typu email alebo url, nie dátovému typu JavaScriptu. Prázdna e-mailová adresa túto chybu sama osebe nespôsobí.
ValidityState.tooShort sa vzťahuje na neprázdnu hodnotu kratšiu ako minlength v poli, ktoré toto obmedzenie podporuje. Musí byť nastavený príznak dirty value a poslednú zmenu hodnoty musel vykonať používateľ. Priradenie do .value túto kontrolu dĺžky nespustí; samotné minlength nevyžaduje zadanie hodnoty.
Príklad zachováva jeden objekt stavu a číta ho po zmenách. Pri 'x' zostáva tooShort hodnotou false, pretože hodnotu nastavuje skript. Spustite ho v prehliadači; prítomnosť Node 24 v repozitári nedokazuje podporu tohto API.
Príklady
(() => {
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();
})();Výsledok
{"valid":false,"valueMissing":true,"typeMismatch":false,"tooShort":false}
{"valid":false,"valueMissing":false,"typeMismatch":true,"tooShort":false}
{"valid":true,"valueMissing":false,"typeMismatch":false,"tooShort":false}Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.