SubmitEvent()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年9月以降、すべてのブラウザーで利用可能です。
SubmitEvent() コンストラクターは、新しい SubmitEvent オブジェクトを作成して返します。これは HTML フォームで発行された submit イベントを表現するために使用されます。
構文
js
new SubmitEvent(type)
new SubmitEvent(type, options)
引数
type-
イベントの名前を表す文字列。 大文字と小文字は区別され、ブラウザーは常に
submitに設定します。 options省略可-
オブジェクトで、
Event()で定義されているプロパティに加え、以下のプロパティを持つことができます。submitter省略可-
フォームを送信するきっかけとなった送信ボタンである
HTMLElementオブジェクトです。
返値
指定された入力コントロールを使用して構成された SubmitEvent オブジェクト。
例
このコードでは、現在の文書内のフォームを探し、そのフォームに submit クラスを持つ HTML <button> 探します。
次に、新しい SubmitEvent を作成し、その submitter には、特定したボタン（またはボタンが見つからなかった場合は null ）を設定します。そして、イベントをフォームに送信し、ボタンによって送信されたことをフォームに指示します。
js
const form = document.querySelector("form");
const formTrigger = form.querySelector("button.submit");
const submitEvent = new SubmitEvent("submit", { submitter: formTrigger });
form.dispatchEvent(submitEvent);
この例はやや作為的なもので、ほぼすべての処理をもっと簡単に行うことができますが、これによって処理を深く制御することができ、それが有用となる場合があります。
仕様書
| 仕様書 |
|---|
| HTML # submitevent |