Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
HTMLFormElement: submit Event
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Dassubmit-Ereignis tritt auf, wenn ein<form>-Element übermittelt wird.
Beachten Sie, dass dassubmit-Ereignis auf dem<form>-Element selbst ausgelöst wird und nicht auf einem<button> oder<input type="submit"> innerhalb des Formulars. Jedoch enthält dasSubmitEvent, das gesendet wird, um die Aktivierung der Formularübermittlung anzuzeigen, einesubmitter-Eigenschaft, die den Button beschreibt, der ausgelöst wurde, um die Übermittlungsanforderung zu starten.
Dassubmit-Ereignis tritt auf, wenn:
- der Benutzer auf einenSubmit-Button klickt,
- der Benutzer dieEnter-Taste drückt, während ein Feld bearbeitet wird (z.B.<input type="text">) in einem Formular,
- ein Skript die Methode
form.requestSubmit()aufruft
Jedoch wird das Ereignisnicht an das Formular gesendet, wenn ein Skript die Methodeform.submit() direkt aufruft.
Hinweis:Der Versuch, ein Formular zu übermitteln, das dieValidierung nicht besteht, löst eininvalid-Ereignis aus. In diesem Fall verhindert die Validierung die Formularübermittlung, und es gibt somit keinsubmit-Ereignis.
In diesem Artikel
Syntax
Verwenden Sie den Ereignisnamen in Methoden wieaddEventListener() oder setzen Sie eine Event-Handler-Eigenschaft.
addEventListener("submit", (event) => { })onsubmit = (event) => { }Ereignistyp
EinSubmitEvent. Erbt vonEvent.
Ereigniseigenschaften
Zusätzlich zu den unten aufgeführten Eigenschaften erbt diese Schnittstelle die Eigenschaften ihrer Elternschnittstelle,Event.
submitterSchreibgeschütztEin
HTMLElement-Objekt, das den Button oder ein anderes Element identifiziert, welches ausgelöst wurde, um die Formularübermittlung zu starten.
Beispiele
Dieses Beispiel verwendetEventTarget.addEventListener(), um auf die Formularübermittlung zu reagieren, und protokolliert den aktuellenEvent.timeStamp, wann immer dies geschieht. Danach wird die Standardaktion der Formularübermittlung verhindert.
HTML
<form> <label>Test field: <input type="text" /></label> <br /><br /> <button type="submit">Submit form</button></form><p></p>JavaScript
const form = document.getElementById("form");const log = document.getElementById("log");function logSubmit(event) { log.textContent = `Form Submitted! Timestamp: ${event.timeStamp}`; event.preventDefault();}form.addEventListener("submit", logSubmit);Ergebnis
Spezifikationen
| Specification |
|---|
| HTML> # event-submit> |
| HTML> # handler-onsubmit> |