CKTIS / JavaScript
HTMLInputElement.validity — stav platnosti vstupního pole
HTMLInputElement.validity zpřístupňuje aktuální stav ověřování omezení vstupního pole jako objekt ValidityState. Jeho příznaky označují konkrétní problémy a valid udává, zda není nastaven žádný chybový příznak.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
input.validity
input.validity.valid
input.validity.valueMissingHTMLInputElement.validity je vlastnost pouze pro čtení, která vrací živý objekt ValidityState: uložený odkaz odráží pozdější změny vstupního pole. Pouze pro čtení jsou i jeho příznaky. Toto rozhraní prohlížeče definuje HTML, nikoli ECMAScript; samotná dostupnost Node.js jeho podporu nezaručuje.
valueMissing označuje chybějící povinnou hodnotu, typeMismatch formát neodpovídající typu a patternMismatch nesoulad s pattern. Další chybové příznaky jsou tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput a customError. To, zda se uplatní, závisí na typu pole a omezeních. valid má hodnotu true, když mají všechny chybové příznaky hodnotu false.
Čtení validity nezobrazí zprávu ani nevyvolá invalid. checkValidity() ověří ovládací prvek a může vyvolat invalid; reportValidity() může navíc uživateli zobrazit problém. willValidate určuje účast na ověřování: i zakázané vstupní pole může mít chybové příznaky, přestože se ověřování neúčastní.
setCustomValidity('Blocked') nastaví customError; vymažete jej pomocí setCustomValidity(''). Samotná oprava hodnoty chybu nevymaže. Příklad ukazuje změny prostřednictvím uloženého objektu state, aniž by znovu četl input.validity. Ověřování v prohlížeči nenahrazuje kontrolu dat na serveru.
Pří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ýsledek
true false false true true false false true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.