SubmitEvent

建構函式

SubmitEvent()

建立並返回一個新的 SubmitEvent 物件，其 type 和其他選項會按照指定進行配置。請注意，目前 SubmitEvent 唯一有效的 type 是 submit。

例項屬性

除了下面列出的屬性外，此介面還繼承了其父介面 Event 的屬性。

submitter 只讀

一個 HTMLElement 物件，用於標識觸發表單提交的按鈕或其他元素。

例項方法

雖然 SubmitEvent 本身不提供任何方法，但它會繼承其父介面 Event 提供的任何方法。

示例

在此示例中，一個購物車的提交按鈕可能會根據使用者設定、商店設定以及支付處理商設定的最低或最高購物車總金額等因素而有所不同。每個提交元素的 id 用於識別該按鈕對應的支付處理商。

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

透過使用 submit 事件的 submitter 屬性來獲取提交按鈕，然後從中獲取 ID，從而獲得處理程式 ID。有了這個 ID，我們就可以呼叫一個 processOrder() 函式來處理訂單，並將表單和處理程式 ID 傳遞過去。

規範

瀏覽器相容性