SubmitEvent: SubmitEvent() 构造函数

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

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。