SubmitEvent: SubmitEvent() Konstruktor

Der SubmitEvent()-Konstruktor erstellt und gibt ein neues SubmitEvent-Objekt zurück, das verwendet wird, um ein submit-Ereignis darzustellen, das bei einem HTML-Formular ausgelöst wird.

Syntax

js
new SubmitEvent(type)
new SubmitEvent(type, options)

Parameter

type

Ein String mit dem Namen des Ereignisses. Er ist schreibungsabhängig, und Browser setzen ihn immer auf submit.

options Optional

Ein Objekt, das, zusätzlich zu den in Event() definierten Eigenschaften, die folgenden Eigenschaften haben kann:

submitter Optional

Ein HTMLElement-Objekt, das die Schaltfläche ist, die die Formularübermittlung ausgelöst hat.

Rückgabewert

Ein SubmitEvent-Objekt, das mit den angegebenen Eingaben konfiguriert ist.

Beispiele

Dieses Codebeispiel findet ein Formular im aktuellen Dokument und dann ein HTML <button> innerhalb des Formulars mit der Klasse submit. Anschließend wird ein neues SubmitEvent erstellt, das mit seinem submitter auf die identifizierte Schaltfläche (oder null, wenn die Schaltfläche nicht gefunden wurde) gesetzt konfiguriert wird. Anschließend wird das Ereignis an das Formular gesendet, um dem Formular mitzuteilen, dass es durch die Schaltfläche übermittelt wurde.

js
const form = document.querySelector("form");
const formTrigger = form.querySelector("button.submit");
const submitEvent = new SubmitEvent("submit", { submitter: formTrigger });

form.dispatchEvent(submitEvent);

Dies ist ein etwas konstruiertes Beispiel, da Sie fast alles davon viel einfacher tun können, aber es gibt Ihnen eine tiefgehende Kontrolle über den Prozess, die nützlich sein kann.

Spezifikationen

Specification
HTML Standard
# submitevent

Browser-Kompatibilität

BCD tables only load in the browser