SubmitEvent - 定义了用于表示 HTML 表单的 submit 事件的对象

SubmitEvent 接口定义了用于表示 HTML 表单的 submit 事件的对象。调用表单的提交操作时,会在 <form> 处引发此事件。

构造函数

SubmitEvent()

创建并返回一个新的 SubmitEvent 对象,该对象的 type 和其他选项均按指定配置。注意,当前,SubmitEvent 的唯一有效 typesubmit

属性

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

submitter 只读

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

方法

尽管 SubmitEvent 没有没有特有的方法,但它继承了其父接口 Event 的方法。

实例

在该实例中,购物车可具有多种不同的提交按钮,取决于诸如用户的设置,商店的设置以及由支付处理器建立的任何最小或最大购物卡总数之类的因素。每个提交元素的 id 用于标识按钮对应的付款处理器。

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

  if (handler) {
    processOrder(form, handler);
  } else {
    showAlertMessage("选择了未知或不可接受的付款类型。请再试一遍。", "OK");
  }
});

通过使用 submit 事件的 submitter 属性获取提交按钮来获取处理程序 ID。然后,我们可以调用 processOrder() 函数来处理订单,并传递表单和处理程序 ID。

规范

规范 状态 备注
HTML Living Standard
SubmitEvent.submitter 的定义
现行的标准 -

桌面浏览器兼容性

暂无兼容数据