stopImmediatePropagation() メソッド
event.stopImmediatePropagation()
stopImmediatePropagation() メソッドは、addEventListener() によって複数の同じイベントリスナーが設定されている場合にこのメソッド以降のリスナーを実効しないようにする Event インターフェイスのメソッドです。
addEventListener() による同じイベントは定義順に実行されていきます。stopImmediatePropagation() メソッドによってこのメソッド以降のリスナーを実行しないようにできます。
on~
といったイベントハンドラーは同じイベントを定義すると新たなもので上書きされますので、同じイベントを複数定義することはできません。
ページ内 Index
Syntax
返り値はないです。
event.stopImmediatePropagation();
引数(Parameter Values)
引数はないです。
Example
stopImmediatePropagation() メソッドの例です。
同じイベントをaddEventListener() で複数設定してあります。2回目のイベントリスナーで stopImmediatePropagation() メソッドを実行するために3回目のイベントリスナーはありません。
処理速度が早いため、1つ目と2つ目のイベントリスナーを同時実行しているようにみえますがイベントリスナーの定義順に順次実行しています。