Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Događaji `submit` i `input` u HTML obrascima

Događajem `input` reagiraj na uređivanje polja, a događajem `submit` obradi slanje obrasca u pravom trenutku postupka provjere.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

form.addEventListener("submit", onSubmit);
form.addEventListener("input", onInput);
form.requestSubmit();
form.requestSubmit(submitter);
form.submit();

input nastaje na elementu obrasca koji se uređuje i širi se prema gore kroz stablo DOM-a. U slušatelju na obrascu event.target označava element, a event.currentTarget označava obrazac dok se slušatelj izvršava. Ako je element izvan obrasca i povezan je s njim atributom form, sama povezanost ne prenosi događaj do obrasca. Koristi input za povratnu informaciju tijekom uređivanja; change označava potvrđenu promjenu, kod tekstnog polja obično pri gubitku fokusa. Dodjela vrijednosti svojstvu .value sama ne pokreće input.

submit nastaje na obrascu, a ne na gumbu. To je SubmitEvent koji se širi prema gore i može se otkazati. Slušaj ga umjesto događaja click na gumbu kako bi obradio i implicitno slanje, primjerice tipkom Enter kad preglednik to podržava. event.submitter označava gumb za slanje ili ima vrijednost null ako nijedan gumb nije pokrenuo slanje. Za sprječavanje zadanog slanja pozovi event.preventDefault() u slušatelju prije bilo kojeg await.

form.requestSubmit() slijedi uobičajena pravila slanja bez odabira gumba. form.requestSubmit(button) koristi zadani gumb i uvažava njegove postavke kao što su formaction i formnovalidate. Ako se provjera ograničenja ne preskoči i ne uspije, nevaljani elementi primaju invalid, a submit se ne pokreće. Element koji nije gumb za slanje uzrokuje TypeError; gumb za slanje koji ne pripada tom obrascu uzrokuje NotFoundError.

Izravan poziv form.submit() preskače provjeru ograničenja i ne pokreće submit. Element kojem je name ili id jednak submit može zakloniti metodu. Provjera u pregledniku ne zamjenjuje provjeru na poslužitelju. To su API-ji web-platforme, a ne dio ECMAScripta 2024; provjeri podršku u ciljnom okruženju.

Primjeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Form submit and input events</title>
</head>
<body>
<script>
(() => {
  const form = document.createElement("form");
  const field = document.createElement("input");
  field.type = "text";
  field.required = true;

  const button = document.createElement("button");
  button.type = "submit";
  button.value = "save";
  button.textContent = "Save";
  form.append(field, button);

  field.addEventListener("invalid", (event) => {
    event.preventDefault();
    console.log("invalid");
  });
  form.addEventListener("input", (event) => {
    if (event.target === field) console.log(`input: ${field.value}`);
  });
  form.addEventListener("submit", (event) => {
    event.preventDefault();
    console.log(`submit: ${event.submitter.value}`);
  });

  document.body.append(form);
  try {
    form.requestSubmit(button);
    field.value = "Ada";
    console.log(`set: ${field.value}`);
    field.dispatchEvent(new Event("input", { bubbles: true }));
    form.requestSubmit(button);
  } finally {
    form.remove();
  }
})();
</script>
</body>
</html>

Rezultat

invalid
set: Ada
input: Ada
submit: save

Spremi primjer kao HTML datoteku i otvori je u pregledniku. Otvori konzolu i ponovno učitaj stranicu. Prvi zahtjev ispisuje `invalid`. Nakon `set: Ada` tek ručno pokrenuti događaj daje `input: Ada`; drugi zahtjev ispisuje `submit: save`, ali slušatelj otkazuje slanje.

Povezane lekcije

  • JavaScript · Lekcija 15 · Napredno · Verzija: 4

Izvori