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

CKTIS / JavaScript

Formuláre a kontrola platnosti

Pomocou udalosti `input` reaguj na zmeny v poli a pomocou `submit` spracuj odoslanie formulára po úspešnej štandardnej validácii. Rozhranie `HTMLFormElement` ponúka aj metódy na explicitnú kontrolu platnosti formulára.

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

field.addEventListener("input", handler); form.addEventListener("submit", handler); form.checkValidity(); form.reportValidity(); form.requestSubmit();

HTMLFormElement je rozhranie DOM prehliadača, ktoré reprezentuje prvok form. Vlastnosť form.elements sprístupňuje ovládacie prvky priradené k formuláru. Ide o webové API, nie o súčasť jazyka ECMAScript.

Pomocou udalosti input môžeš reagovať na zmeny vykonané používateľom, napríklad aktualizovať pomôcku počas písania. Samotné priradenie hodnoty do field.value v JavaScripte nevyvolá udalosť input. Atribút required spôsobí, že prázdne textové pole nie je platné. form.checkValidity() vráti výsledok ako logickú hodnotu. form.reportValidity() tiež vracia logickú hodnotu a navyše používateľovi zobrazuje chyby validácie, ak sa udalosť invalid príslušného ovládacieho prvku nezruší. Zrušenie tejto udalosti nemení výsledok validácie: metóda vráti false bez toho, aby zobrazila chybu pre tento prvok.

Pri bežnom pokuse o odoslanie prehliadač najprv skontroluje obmedzenia. Ak je niektoré pole neplatné, prehliadač zablokuje odoslanie a udalosť submit sa nevyvolá. Ak validácia prebehne úspešne, udalosť submit sa vyvolá na formulári, nie na tlačidle. Volaním event.preventDefault() v obsluhe udalosti zrušíš predvolené odoslanie.

Ten istý postup môžeš spustiť z kódu pomocou form.requestSubmit(). Priame volanie form.submit() obíde validáciu aj udalosť submit. Validácia v prehliadači pomáha používateľom opraviť zadané údaje, ale nenahrádza validáciu na serveri.

Príklady

<!doctype html>
<meta charset="utf-8">
<title>Form validity</title>
<form id="profile">
  <label>Name <input name="displayName" required></label>
  <button type="submit">Save</button>
</form>
<pre id="log"></pre>
<script>
  const form = document.querySelector('#profile');
  const field = form.elements.namedItem('displayName');
  const log = document.querySelector('#log');
  const append = (line) => { log.textContent += line + '\n'; };

  field.addEventListener('input', () => {
    append(`input: ${form.checkValidity()}`);
  });
  form.addEventListener('submit', (event) => {
    event.preventDefault();
    append(`submit: ${field.value}`);
  });

  append(`initial: ${form.checkValidity()}`);
</script>

Výsledok

initial: false
input: true
submit: A

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje