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 September 2021.
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. optionsOptional-
Ein Objekt, das neben den in
Event()definierten Eigenschaften folgende Eigenschaften haben kann:submitterOptional-
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 |