CKTIS / JavaScript
Obrasci i provjera valjanosti
Događajem `input` reagiraj na izmjene u polju, a događajem `submit` obradi slanje obrasca nakon uspješne standardne provjere valjanosti. `HTMLFormElement` nudi i metode za izričitu provjeru valjanosti obrasca.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
field.addEventListener("input", handler); form.addEventListener("submit", handler); form.checkValidity(); form.reportValidity(); form.requestSubmit();HTMLFormElement je sučelje DOM-a u pregledniku koje predstavlja element form. Svojstvo form.elements omogućuje pristup kontrolama povezanima s obrascem. To je web API, a ne dio jezika ECMAScript.
Osluškuj događaj input da bi reagirao na korisnikove izmjene, primjerice da ažuriraš savjet dok korisnik tipka. Sama dodjela vrijednosti svojstvu field.value u JavaScriptu ne pokreće događaj input. Zbog atributa required prazno tekstno polje nije valjano. form.checkValidity() vraća rezultat kao logičku vrijednost. form.reportValidity() također vraća logičku vrijednost i korisniku prikazuje pogreške u provjeri valjanosti, osim ako je događaj invalid dotične kontrole otkazan. Otkazivanje tog događaja ne mijenja rezultat provjere: metoda vraća false bez prikazivanja pogreške za tu kontrolu.
Pri uobičajenom pokušaju slanja preglednik najprije provjerava ograničenja. Ako neko polje nije valjano, preglednik blokira slanje i događaj submit se ne pokreće. Ako je provjera uspješna, submit se pokreće na obrascu, a ne na gumbu. Pozivom event.preventDefault() u funkciji za obradu tog događaja otkazuješ zadano slanje.
Upotrijebi form.requestSubmit() da pokreneš isti postupak iz koda. Izravan poziv form.submit() preskače i provjeru valjanosti i događaj submit. Provjera valjanosti u pregledniku pomaže korisnicima da isprave unose, ali ne zamjenjuje provjeru na poslužitelju.
Primjeri
<!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>Rezultat
initial: false input: true submit: A
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.