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

CKTIS / JavaScript

ValidityState — stav validace formulářového pole

ValidityState zpřístupňuje příznaky chyb formulářového pole pouze pro čtení. Umožňuje rozlišit chybějící povinnou hodnotu, neplatný formát a příliš krátký text, s důležitou výjimkou pro hodnoty nastavené skriptem.

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

const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;

ValidityState je rozhraní HTML Web API, nikoli součást ECMAScriptu. Objekt dostupný přes input.validity se průběžně aktualizuje; jeho booleovské příznaky jsou pouze pro čtení. ValidityState.valid má hodnotu true, když není nastaven žádný z ostatních příznaků chyby.

ValidityState.valueMissing signalizuje nesplnění omezení required: u textového pole to znamená prázdnou hodnotu. ValidityState.typeMismatch znamená, že hodnota neodpovídá pravidlům typu email nebo url, nikoli datovému typu JavaScriptu. Prázdná e-mailová adresa tuto chybu sama o sobě nezpůsobí.

ValidityState.tooShort se vztahuje na neprázdnou hodnotu kratší než minlength u pole, které toto omezení podporuje. Musí být nastaven příznak dirty value a poslední změnu hodnoty musel provést uživatel. Přiřazení do .value tuto kontrolu délky nespustí; samotné minlength nevyžaduje zadání hodnoty.

Příklad zachovává jeden objekt stavu a čte jej po změnách. U 'x' zůstává tooShort hodnotou false, protože hodnotu nastavuje skript. Spusťte jej v prohlížeči; přítomnost Node 24 v repozitáři nedokazuje podporu tohoto API.

Pří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ýsledek

{"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ýsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje