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

浏览器兼容性