WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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