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

CKTIS / JavaScript

ValidityState: celková platnost a příčiny chyb

Pomocí `element.validity` rozlišíš platné pole od chybějící povinné hodnoty, nesprávného formátu nebo příliš krátké hodnoty zadané uživatelem.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

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

element.validity vrací objekt ValidityState pro formulářový prvek. Jeho booleovské vlastnosti jsou jen pro čtení a odrážejí aktuální stav: uložený odkaz na objekt není snímkem stavu. Jde o rozhraní webové platformy, nikoli o součást ECMAScriptu.

valid je true, jen když není nastaven žádný příznak chyby, včetně těch, které zde nejsou popsány, například customError. Více příznaků může být true současně. valueMissing je true, pokud chybí hodnota vyžadovaná atributem required, například u prázdného povinného e-mailového pole.

typeMismatch je true, pokud neprázdná hodnota neodpovídá syntaktickým pravidlům HTML pro type="email" nebo type="url". U e-mailu dovoluje multiple seznam adres oddělených čárkami. Prázdné povinné e-mailové pole má valueMissing, nikoli typeMismatch. Kontrola syntaxe nepotvrzuje existenci adresy.

tooShort je true, pokud se na input nebo textarea vztahuje minlength, je nastaven příznak změny hodnoty (dirty value flag), hodnotu naposledy změnil uživatel a neprázdná hodnota zpřístupněná přes API má méně kódových jednotek UTF-16, než stanoví minimum. Samotné minlength nečiní pole povinným. Přiřazení do .value tuto chybu nevyvolá, ani když pak zavoláš checkValidity() nebo reportValidity().

Pomocí valid zjisti celkový stav pole a podle příznaků vyber vhodnou zprávu. Odeslaná data znovu ověř na serveru: validaci v prohlížeči lze obejít.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ValidityState example</title>
</head>
<body>
  <label for="email">Email:</label>
  <input id="email" type="email" required minlength="8" autocomplete="off">
  <button type="button">Next</button>

  <script>
    (() => {
      const input = document.getElementById('email');
      const state = input.validity;
      const log = (step) => console.log([
        step, state.valid, state.valueMissing, state.typeMismatch, state.tooShort
      ].join(' '));

      input.value = '';
      log('empty');
      input.value = 'not-an-email';
      log('wrong-format');
      input.value = 'a@b.co';
      log('scripted-short');

      input.value = '';
      input.addEventListener('change', () => log('user-short'), { once: true });
    })();
  </script>
</body>
</html>

Výsledek

empty false true false false
wrong-format false false true false
scripted-short true false false false
user-short false false false true

Otevři příklad jako stránku HTML v prohlížeči a sleduj výstup v konzoli prohlížeče. Po prvních třech řádcích napiš do pole `a@b.co` a stiskni Tab. Za označením kroku následují `valid`, `valueMissing`, `typeMismatch` a `tooShort`. Tatáž adresa o šesti kódových jednotkách je v obou případech syntakticky platná, ale `minLength = 8` poruší až při ručním zadání.

Související lekce

  • JavaScript · Lekce 22 · Středně pokročilá · Verze: 3

Zdroje