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
- HTML Standard — Form submission algorithm
- HTML Standard — Constraints: Security
- HTMLFormElement: submit event
- Element: input event
- HTMLElement: change event
- HTMLFormElement: requestSubmit() method
- HTMLFormElement: submit() method
- Event: currentTarget property
- Event: preventDefault() method
- EventTarget: dispatchEvent() method