SubmitEvent: SubmitEvent() 建構函式

Baseline 已廣泛支援

此功能已成熟,並可在多種裝置和瀏覽器版本上執行。自 2021 年 9 月起,所有瀏覽器均已支援此功能。

SubmitEvent() 建構函式用於建立和返回一個新的 SubmitEvent 物件,該物件用於表示在 submit 事件時在 HTML 表單上觸發的事件。

語法

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

引數

type

一個包含事件名稱的字串。它區分大小寫,並且瀏覽器始終將其設定為 submit

options 可選

一個物件,除了 Event() 中定義的屬性外,還可以包含以下屬性:

submitter 可選

一個 HTMLElement 物件,即觸發表單提交的提交按鈕。

返回值

一個使用給定輸入配置的 SubmitEvent 物件。

示例

此程式碼段在當前文件中定位一個表單,然後在該表單內查詢一個帶有 submit 類的 HTML <button> 元素。接下來,建立一個新的 SubmitEvent,並將其 submitter 設定為已識別的按鈕(如果未找到按鈕則設定為 null)。然後將事件傳送到表單,告知表單它已被該按鈕提交。

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

form.dispatchEvent(submitEvent);

這是一個有些牽強的例子,因為你可以更輕鬆地完成其中大部分工作,但它能讓你深入控制這個過程,這可能會很有用。

規範

規範
HTML
# submitevent

瀏覽器相容性