Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Obrazci in preverjanje veljavnosti

Z dogodkom `input` se odzovi na spremembe v polju, z dogodkom `submit` pa obravnavaj oddajo obrazca po uspešnem običajnem preverjanju veljavnosti. `HTMLFormElement` ponuja tudi metode za izrecno preverjanje veljavnosti obrazca.

Različica: 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 vmesnik brskalnikovega DOM-a za element form. Lastnost form.elements omogoča dostop do kontrolnikov, povezanih z obrazcem. To je spletni API, ne del jezika ECMAScript.

Poslušaj dogodek input, da se odzoveš na spremembe, ki jih naredi uporabnik, na primer da med tipkanjem posodobiš namig. Če v JavaScriptu nastaviš vrednost field.value, se samo zaradi tega dogodek input ne sproži. Zaradi atributa required je prazno besedilno polje neveljavno. form.checkValidity() vrne rezultat kot logično vrednost. Tudi form.reportValidity() vrne logično vrednost in uporabniku prikaže napake pri preverjanju veljavnosti, razen če je dogodek invalid zadevnega kontrolnika preklican. Preklic tega dogodka ne spremeni rezultata preverjanja: metoda vrne false, ne da bi prikazala napako za ta kontrolnik.

Pri običajnem poskusu oddaje brskalnik najprej preveri omejitve. Če je katero polje neveljavno, brskalnik prepreči oddajo in dogodek submit se ne sproži. Če je preverjanje uspešno, se submit sproži na obrazcu, ne na gumbu. Klic event.preventDefault() v obravnavalniku dogodka prekliče privzeto oddajo.

Z metodo form.requestSubmit() zaženeš isti postopek iz kode. Neposreden klic form.submit() preskoči tako preverjanje veljavnosti kot dogodek submit. Preverjanje v brskalniku uporabnikom pomaga popraviti vnose, ne nadomesti pa preverjanja na strežniku.

Primeri

<!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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri