Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

ValidityState — stav validácie poľa formulára

ValidityState sprístupňuje príznaky chýb poľa formulára iba na čítanie. Umožňuje rozlíšiť chýbajúcu povinnú hodnotu, neplatný formát a príliš krátky text, s dôležitou výnimkou pre hodnoty nastavené skriptom.

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

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

ValidityState je rozhranie HTML Web API, nie súčasť ECMAScriptu. Objekt dostupný cez input.validity sa priebežne aktualizuje; jeho booleovské príznaky sú iba na čítanie. ValidityState.valid má hodnotu true, keď nie je nastavený žiadny z ostatných príznakov chyby.

ValidityState.valueMissing signalizuje nesplnenie obmedzenia required: pri textovom poli to znamená prázdnu hodnotu. ValidityState.typeMismatch znamená, že hodnota nezodpovedá pravidlám typu email alebo url, nie dátovému typu JavaScriptu. Prázdna e-mailová adresa túto chybu sama osebe nespôsobí.

ValidityState.tooShort sa vzťahuje na neprázdnu hodnotu kratšiu ako minlength v poli, ktoré toto obmedzenie podporuje. Musí byť nastavený príznak dirty value a poslednú zmenu hodnoty musel vykonať používateľ. Priradenie do .value túto kontrolu dĺžky nespustí; samotné minlength nevyžaduje zadanie hodnoty.

Príklad zachováva jeden objekt stavu a číta ho po zmenách. Pri 'x' zostáva tooShort hodnotou false, pretože hodnotu nastavuje skript. Spustite ho v prehliadači; prítomnosť Node 24 v repozitári nedokazuje podporu tohto API.

Prí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ýsledok

{"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ýsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje