From 586b39e7a70f908cfe044af4232a52ded34ea65b Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 30 Jan 2022 10:53:48 +0900 Subject: EventTarget インターフェイスの文書を移行 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../ja/web/api/eventtarget/dispatchevent/index.md | 42 ++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 files/ja/web/api/eventtarget/dispatchevent/index.md (limited to 'files/ja/web/api/eventtarget/dispatchevent/index.md') diff --git a/files/ja/web/api/eventtarget/dispatchevent/index.md b/files/ja/web/api/eventtarget/dispatchevent/index.md new file mode 100644 index 0000000000..a712cf21cd --- /dev/null +++ b/files/ja/web/api/eventtarget/dispatchevent/index.md @@ -0,0 +1,42 @@ +--- +title: EventTarget.dispatchEvent() +slug: Web/API/EventTarget/dispatchEvent +tags: + - DOM + - Gecko + - Gecko DOM Reference + - 要更新 +translation_of: Web/API/EventTarget/dispatchEvent +--- +

{{APIRef("DOM Events")}}

+ +

特定の {{domxref("EventTarget")}} に {{domxref("Event")}} をディスパッチし、影響する {{domxref("EventListener")}} を適切な順序で呼び出します。通常のイベント処理ルール（capturing フェーズと任意的な bubbling フェーズを含む）は dispatchEvent() で手動でディスパッチされたイベントにも適用されます。

+ +

構文

+ +
cancelled = !target.dispatchEvent(event)
+
+ + + +

もしメソッド呼び出しの前にイベントが初期化されず、イベントのタイプが指定されなかった場合、あるいはイベントのタイプが null または空文字列だった場合、dispatchEvent は UNSPECIFIED_EVENT_TYPE_ERR を投げます。イベントハンドラから投げられた例外は、キャッチされなかった例外として報告されます。イベントハンドラは入れ子のコールスタック上で実行され、実行が完了するまで呼び出し元をブロックしますが、例外は呼び出し元まで伝播しません。

+ +

注

+ +

dispatchEvent は 作成-初期化-ディスパッチ プロセスの最後のステップであり、イベントを実装系のイベントモデルにディスパッチするのに使われます。イベントは document.createEvent メソッドを使って作成され、initEvent メソッド、またはその他の、initMouseEvent や initUIEvent といったより具体的な初期化メソッドを使って初期化されます。

+ +

Event オブジェクトのリファレンスも参照してください。

+ +

例

+ +

Creating and triggering events を参照。

+ +

仕様書

+ + -- cgit v1.2.3-54-g00ecf