CKTIS / JavaScript
`submit`- und `input`-Ereignisse bei HTML-Formularen
Reagiere mit `input` auf Änderungen und behandle mit `submit` das Absenden des Formulars an der richtigen Stelle im Validierungsablauf.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
form.addEventListener("submit", onSubmit);
form.addEventListener("input", onInput);
form.requestSubmit();
form.requestSubmit(submitter);
form.submit();input entsteht am bearbeiteten Formularelement und steigt im DOM-Baum auf (Bubbling). In einem Listener am Formular bezeichnet event.target das Formularelement, event.currentTarget während des Aufrufs das Formular. Liegt das Element außerhalb des Formulars und ist ihm nur über das Attribut form zugeordnet, erreicht sein Ereignis das Formular dadurch nicht. Nutze input für unmittelbares Feedback; change steht für eine übernommene Änderung, bei Textfeldern meist beim Fokusverlust. Eine Zuweisung an .value löst für sich genommen kein input aus.
submit entsteht am Formular, nicht an der Schaltfläche. Es ist ein aufsteigendes, abbrechbares SubmitEvent. Höre darauf statt auf click an der Schaltfläche, um auch implizites Absenden zu erfassen, etwa per Eingabetaste, wenn der Browser dies unterstützt. event.submitter bezeichnet die Absende-Schaltfläche oder ist null, wenn keine Schaltfläche das Absenden ausgelöst hat. Um die Standardaktion zu verhindern, rufe im Listener vor jedem await event.preventDefault() auf.
form.requestSubmit() folgt den normalen Regeln ohne Auswahl einer Schaltfläche. form.requestSubmit(button) verwendet diese Schaltfläche und berücksichtigt deren Einstellungen wie formaction und formnovalidate. Wird die Prüfung der Eingabebedingungen nicht übersprungen und schlägt sie fehl, erhalten ungültige Felder invalid, und submit bleibt aus. Ein Element, das keine Absende-Schaltfläche ist, führt zu TypeError; eine Absende-Schaltfläche, die nicht zu diesem Formular gehört, zu NotFoundError.
Ein direkter Aufruf von form.submit() überspringt die Prüfung der Eingabebedingungen und löst kein submit aus. Ein Formularelement mit name oder id gleich submit kann die Methode verdecken. Die Prüfung im Browser ersetzt keine serverseitige Validierung. Diese APIs gehören zur Webplattform, nicht zu ECMAScript 2024; prüfe die Unterstützung in der Zielumgebung.
Beispiele
<!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>Ergebnis
invalid set: Ada input: Ada submit: save
Speichere das Beispiel als HTML-Datei und öffne es im Browser. Öffne die Konsole und lade die Seite neu. Die erste Anfrage protokolliert `invalid`. Nach `set: Ada` erzeugt erst das manuell ausgelöste Ereignis `input: Ada`; die zweite Anfrage protokolliert `submit: save`, doch der Listener verhindert das Absenden.
Zugehörige Lektionen
- JavaScript · Lektion 15 · Fortgeschritten · Version: 4
Quellen
- 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