HTMLFormElement: submit() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

HTMLFormElement.submit() 方法会提交指定的 <form>

此方法类似于激活表单的 submit <button>,但并不完全相同。然而,直接调用此方法时:

  • 不会引发 submit 事件。特别是,表单的 onsubmit 事件处理程序不会运行。
  • 不会触发 约束验证

HTMLFormElement.requestSubmit() 方法与激活表单的 submit <button> 相同,没有这些差异。

nameidsubmit 的表单控件(例如 submit 按钮)会覆盖表单的 submit 方法。尝试调用 myForm.submit(); 会抛出错误“submit is not a function”,因为在这种情况下 submit 指的是 nameidsubmit 的表单控件。

使用 HTMLFormElement.submit() 时,<input> 元素的 type 属性为 "submit" 的不会随表单一起提交,但当您使用原始 HTML 表单提交时,它会被提交。

语法

js
submit()

参数

无。

返回值

无(undefined)。

示例

js
document.forms["my-form"].submit();

规范

规范
HTML
# dom-form-submit-dev

浏览器兼容性