CKTIS / JavaScript
HTMLInputElement.validity — stav platnosti vstupného poľa
HTMLInputElement.validity sprístupňuje aktuálny stav overovania obmedzení vstupného poľa ako objekt ValidityState. Jeho príznaky označujú konkrétne problémy a valid udáva, či nie je nastavený žiadny chybový príznak.
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
input.validity
input.validity.valid
input.validity.valueMissingHTMLInputElement.validity je vlastnosť iba na čítanie, ktorá vracia živý objekt ValidityState: uložený odkaz odráža neskoršie zmeny vstupného poľa. I jeho príznaky sú iba na čítanie. Toto rozhranie prehliadača definuje HTML, nie ECMAScript; samotná dostupnosť Node.js jeho podporu nezaručuje.
valueMissing označuje chýbajúcu povinnú hodnotu, typeMismatch formát nezodpovedajúci typu a patternMismatch nesúlad s pattern. Ďalšie chybové príznaky sú tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput a customError. To, či sa uplatnia, závisí od typu poľa a obmedzení. valid má hodnotu true, keď majú všetky chybové príznaky hodnotu false.
Čítanie validity nezobrazí správu ani nevyvolá invalid. checkValidity() overí ovládací prvok a môže vyvolať invalid; reportValidity() môže navyše používateľovi zobraziť problém. willValidate určuje účasť na overovaní: aj zakázané vstupné pole môže mať chybové príznaky, hoci sa na overovaní nezúčastňuje.
setCustomValidity('Blocked') nastaví customError; vymažete ho pomocou setCustomValidity(''). Samotná oprava hodnoty chybu nevymaže. Príklad ukazuje zmeny prostredníctvom uloženého objektu state bez opätovného čítania input.validity. Overovanie v prehliadači nenahrádza kontrolu údajov na serveri.
Príklady
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);Výsledok
true false false true true false false true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.