SubmitEvent
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
SubmitEvent
インターフェイスは、 HTML フォームの submit
イベントを表現するために使用されるオブジェクトを定義します。このイベントは、フォームの送信操作が呼び出されたときに <form>
で発行されます。
コンストラクター
SubmitEvent()
-
type
と他のオプションが指定されたSubmitEvent
オブジェクトを新しく作成して返します。現在、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(
"不明または未対応の支払い方法が選択されました。やり直してください。",
"OK",
);
}
});
ハンドラー ID は、 submit
イベントの submitter
プロパティを使用して送信ボタンを取得し、そこから ID を取得します。これで、 processOrder()
関数を呼び出して、フォームとハンドラー ID を渡しながら注文を処理することができます。
仕様書
Specification |
---|
HTML Standard # the-submitevent-interface |
ブラウザーの互換性
BCD tables only load in the browser