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
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.
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 |