Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.
SubmitEvent
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2021 browserübergreifend verfügbar.
Die SubmitEvent-Schnittstelle definiert das Objekt, das verwendet wird, um ein submit-Ereignis eines HTML-Formulars darzustellen. Dieses Ereignis wird am <form> ausgelöst, wenn die Absendeaktion des Formulars aufgerufen wird.
Konstruktor
SubmitEvent()-
Erstellt und gibt ein neues
SubmitEvent-Objekt zurück, dessentypeund andere Optionen wie angegeben konfiguriert sind. Beachten Sie, dass derzeit der einzige gültigetypefür einSubmitEventsubmitist.
Instanz-Eigenschaften
Zusätzlich zu den unten aufgeführten Eigenschaften erbt diese Schnittstelle die Eigenschaften ihrer Elternschnittstelle Event.
submitterSchreibgeschützt-
Ein
HTMLElement-Objekt, das die Schaltfläche oder ein anderes Element identifiziert, das aufgerufen wurde, um das Formular abzusenden.
Instanz-Methoden
Obwohl SubmitEvent keine eigenen Methoden anbietet, erbt es alle von seiner Elternschnittstelle Event spezifizierten.
Beispiele
In diesem Beispiel kann ein Warenkorb eine Reihe unterschiedlicher Absende-Schaltflächen haben, abhängig von Faktoren wie den Benutzereinstellungen, den Einstellungen des Shops und möglichen Mindest- oder Höchstgrenzen des Warenkorbs, die von den Zahlungsanbietern festgelegt wurden. Jede der Absendeelemente verwendet die id, um den entsprechenden Zahlungsanbieter zu identifizieren.
let form = document.querySelector("form");
form.addEventListener("submit", (event) => {
let submitter = event.submitter;
let handler = submitter.id;
if (handler) {
processOrder(form, handler);
} else {
showAlertMessage(
"An unknown or unaccepted payment type was selected. Please try again.",
"OK",
);
}
});
Die Handler-ID wird erhalten, indem die submit-Ereignis-Eigenschaft submitter verwendet wird, um die Absende-Schaltfläche zu erhalten, von der wir dann die ID abrufen. Mit dieser Informationen können wir eine processOrder()-Funktion aufrufen, um die Bestellung zu bearbeiten und das Formular sowie die Handler-ID weiterzugeben.
Spezifikationen
| Spezifikation |
|---|
| HTML> # the-submitevent-interface> |
Browser-Kompatibilität
JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.