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

瀏覽器相容性