SubmitEvent | Web API

在此页

构造函数
特性
方法
范例
规范
浏览器兼容性
相关话题

SubmitEvent interface defines the object used to represent an HTML form's submit event. This event is fired at the <form> when the form's submit action is invoked.

构造函数

SubmitEvent(): 创建并返回新 SubmitEvent object whose type and other options are configured as specified. Note that currently the only valid type 对于 SubmitEvent is submit .

特性

In addition to the properties listed below, this interface inherits the properties of its parent interface, 事件 .

submitter 只读: HTMLElement object which identifies the button or other element which was invoked to trigger the form being submitted.

方法

While SubmitEvent offers no methods of its own, it inherits any specified by its parent interface, 事件 .

范例

In this example, a shopping cart may have an assortment of different submit buttons depending on factors such as the user's settings, the shop's settings, and any minimum or maximum shopping card totals established by the payment processors. Each of the submit elements' id is used to identify which payment processor the button corresponds to.

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");
  }
});

The handler ID is obtained by using the submit event's submitter property to get the submit button, from which we then get the ID. With that in hand, we can call a processOrder() function to handle the order, passing along the form and the handler ID.

规范

规范	状态	注释
HTML 实时标准 The definition of 'SubmitEvent' in that specification.	实时标准

浏览器兼容性

更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`SubmitEvent`	Chrome 81	Edge ?	Firefox 75	IE No	Opera ?	Safari ?	WebView Android 81	Chrome Android 81	Firefox Android ?	Opera Android ?	Safari iOS ?	Samsung Internet Android No
`SubmitEvent()` 构造函数	Chrome 81	Edge ?	Firefox 75	IE No	Opera ?	Safari ?	WebView Android 81	Chrome Android 81	Firefox Android ?	Opera Android ?	Safari iOS ?	Samsung Internet Android No
`submitter`	Chrome 81	Edge ?	Firefox 75	IE No	Opera ?	Safari ?	WebView Android 81	Chrome Android 81	Firefox Android ?	Opera Android ?	Safari iOS ?	Samsung Internet Android No

图例

完整支持
不支持
兼容性未知 ?

元数据

最后修改： Aug 28, 2020

在此页

构造函数

特性

方法

范例

规范

浏览器兼容性

图例

相关话题