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.