CKTIS / JavaScript
Dogodka `submit` in `input` v obrazcih HTML
Z dogodkom `input` se odzovi na urejanje polj, z dogodkom `submit` pa obdelaj oddajo obrazca na pravem mestu v postopku preverjanja.
Različica: 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 nastane na urejenem elementu obrazca in se širi navzgor po drevesu DOM. V poslušalcu na obrazcu event.target označuje element, event.currentTarget pa med izvajanjem poslušalca označuje obrazec. Če je element zunaj obrazca in je z njim povezan prek atributa form, sama povezava ne prenese dogodka do obrazca. Uporabi input za sprotni odziv; change pomeni, da je sprememba potrjena, pri besedilnem polju običajno ob izgubi fokusa. Prirejanje vrednosti lastnosti .value samo po sebi ne sproži dogodka input.
submit nastane na obrazcu, ne na gumbu. Gre za SubmitEvent, ki se širi navzgor in ga je mogoče preklicati. Poslušaj ga namesto dogodka click na gumbu, da zajameš tudi implicitno oddajo, na primer s tipko Enter, če jo brskalnik podpira. event.submitter označuje gumb za oddajo ali ima vrednost null, če oddaje ni sprožil noben gumb. Privzeto oddajo preprečiš tako, da v poslušalcu pokličeš event.preventDefault() pred vsakim await.
form.requestSubmit() upošteva običajna pravila oddaje, ne da bi izbral gumb. form.requestSubmit(button) uporabi navedeni gumb in upošteva njegove nastavitve, na primer formaction in formnovalidate. Če se preverjanje omejitev izvede in ne uspe, neveljavni elementi prejmejo invalid, dogodek submit pa se ne sproži. Element, ki ni gumb za oddajo, povzroči TypeError; gumb za oddajo, ki ne pripada temu obrazcu, povzroči NotFoundError.
Neposreden klic form.submit() preskoči preverjanje omejitev in ne sproži dogodka submit. Element, katerega name ali id je submit, lahko zakrije metodo. Preverjanje v brskalniku ne nadomesti preverjanja na strežniku. To so API-ji spletne platforme, ne del ECMAScripta 2024; preveri podporo v ciljnem okolju.
Primeri
<!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
Shrani primer kot datoteko HTML in jo odpri v brskalniku. Odpri konzolo in znova naloži stran. Prva zahteva izpiše `invalid`. Po `set: Ada` šele ročno sproženi dogodek povzroči izpis `input: Ada`; druga zahteva izpiše `submit: save`, vendar poslušalec prekliče oddajo.
Povezane lekcije
- JavaScript · Lekcija 15 · Napredna · Različica: 4
Viri
- 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