Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.valueMissing

HTMLInputElement.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.

Zdroje