HTMLFormElement.requestSubmit()

在此页

句法
用法注意事项
范例
规范
浏览器兼容性
相关话题

HTMLFormElement 方法 requestSubmit() requests that the form be submitted using a specific submit button.

句法

htmlFormElement.requestSubmit(submitter);

参数

submitter 可选

返回值

None.

异常

TypeError: 指定 submitter is not a submit button.
NotFoundError: 指定 submitter isn't a member of the form on which requestSubmit() was called. The submitter must be either a descendant of the form element or must have an form attribute referring to the form.

用法注意事项

The obvious question is: Why does this method exist, when we've had the submit() method since the dawn of time?

The answer is simple. submit() submits the form, but that's all it does. requestSubmit() , on the other hand, acts as if a submit button were clicked. The form's content is validated, and the form is submitted only if validation succeeds. Once the form has been submitted, the submit event is sent back to the form object.

范例

In the example below, the form is submitted by attempting to send the request using requestSubmit() if it's available. If a submit button with the ID main-submit is found, that's used to submit the form. Otherwise, the form is submitted with no submitter parameter, so it's submitted directly by the form itself.

If, on the other hand, requestSubmit() isn't available, this code falls back to calling the form's submit() 方法。

let myForm = document.querySelector("form");
let submitButton = myForm.querySelector("#main-submit");
if (myForm.requestSubmit) {
  if (submitButton) {
    myForm.requestSubmit(submitButton);
  } else {
    myForm.requestSubmit();
  }
} else {
  myForm.submit();
}

规范

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

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`requestSubmit()`	Chrome 76	Edge 79	Firefox 75	IE No	Opera 63	Safari No	WebView Android 76	Chrome Android 76	Firefox Android No	Opera Android 54	Safari iOS No	Samsung Internet Android 12.0

图例

完整支持
不支持

元数据

最后修改： 2020 年 3 月 9 日

在此页

句法

参数

返回值

异常

用法注意事项

范例

规范

浏览器兼容性

图例

相关话题