SubmitEvent

**SubmitEvent** 接口定义了用于表示 HTML 表单的 提交 事件的对象。当表单的提交操作被调用时,此事件将在 <form> 上触发。

Event SubmitEvent

构造函数

SubmitEvent()

创建并返回一个新的 SubmitEvent 对象,其 类型 和其他选项按指定配置。请注意,目前 SubmitEvent 的唯一有效 类型提交

实例属性

除了下面列出的属性外,此接口还继承了其父接口 事件 的属性。

提交者 只读

一个 HTMLElement 对象,它标识用于触发表单提交的按钮或其他元素。

实例方法

虽然 SubmitEvent 本身没有提供任何方法,但它继承了其父接口 事件 指定的任何方法。

示例

在此示例中,购物车可能根据用户设置、商店设置以及支付处理程序建立的任何最小或最大购物车总数,具有各种不同的提交按钮。每个提交元素的 id 用于标识按钮对应于哪个支付处理程序。

js
let form = document.querySelector("form");
form.addEventListener("submit", (event) => {
  let submitter = event.submitter;
  let handler = submitter.id;

  if (handler) {
    processOrder(form, handler);
  } else {
    showAlertMessage(
      "An unknown or unaccepted payment type was selected. Please try again.",
      "OK",
    );
  }
});

处理程序 ID 是通过使用 提交 事件的 提交者 属性获取提交按钮,然后从该按钮中获取 ID 来获得的。有了它,我们就可以调用 processOrder() 函数来处理订单,并传入表单和处理程序 ID。

规范

规范
HTML 标准
# the-submitevent-interface

浏览器兼容性

BCD 表格仅在浏览器中加载