HTMLFormElement.requestSubmit()
HTMLFormElement
的 requestSubmit()
方法要求使用一个指定的提交按钮提交表单。
语法
js
requestSubmit()
requestSubmit(submitter)
参数
submitter
可选-
提交按钮,其属性描述了提交表单的方式。可以是
type
属性为submit
的<input>
或<button>
元素。如果你省略了
submitter
参数,表单元素自身会作为 submitter 使用。
返回值
无(undefined
)。
异常
TypeError
-
如果指定的
submitter
不是一个提交按钮则抛出该错误。 NotFoundError
DOMException
-
如果调用
requestSubmit()
时指定的submitter
不是表单的成员则抛出该错误。submitter 必须是一个表单元素的后代或者必须具有引用表单的form
属性。
使用说明
示例
在下面的示例中,如果可用,会尝试使用 requestSubmit()
发送请求提交表单。如果一个找到有 ID 为 main-submit
的提交按钮,则将其用于提交表单。否则,表单提交时不携带 submitter
参数,所以直接由表单自己提交。
另一方面,如果 requestSubmit()
不是可用的,这个代码回退到调用表单的 submit()
方法。
js
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();
}
规范
Specification |
---|
HTML Standard # dom-form-requestsubmit-dev |
浏览器兼容性
BCD tables only load in the browser