SubmitEvent: SubmitEvent() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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. Es ist groß-/klein-schreibungssensitiv, und Browser setzen es immer auf submit.

options Optional

Ein Objekt, das neben den in Event() definierten Eigenschaften folgende Eigenschaften haben kann:

submitter Optional

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

Rückgabewert

Ein SubmitEvent-Objekt, das anhand der angegebenen Eingaben konfiguriert wird.

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, das auf die identifizierte Schaltfläche gesetzt ist (oder null, wenn die Schaltfläche nicht gefunden wurde), konfiguriert ist. Dann 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 all dies viel einfacher tun können, aber es gibt Ihnen tiefe Kontrolle über den Prozess, was nützlich sein kann.

Spezifikationen

Specification
HTML
# submitevent

Browser-Kompatibilität