JavaScript

stopImmediatePropagation method of JavaScript.

stopImmediatePropagation

　stopImmediatePropagation()は、Eventのメソッドです。同じオブジェクトの同じイベントに複数のリスナーが設定されている場合、このメソッドを実行すると、その時点で他のリスナーを実行しません。

構文


event.stopImmediatePropagation();

Example of use

　同じオブジェクトの同じイベントに複数のリスナーを登録した場合、イベント発生時、登録した順にリスナーが実行されます。


element.addEventListener( "click", callbackFn1 ) ;
element.addEventListener( "click", callbackFn2 ) ;
element.addEventListener( "click", callbackFn3 ) ;
element.addEventListener( "click", callbackFn4 ) ;
element.addEventListener( "click", callbackFn5 ) ;

// callbackFn1 → callbackFn2 → callbackFn3 → callbackFn4 → callbackFn5

　例えば、callbackFn3内で stopImmediatePropagation()を実行した場合、そこでリスナーの伝播が終了し、その後のリスナーが実行されません。


var callbackFn3 = function ( event ) {
	event.stopImmediatePropagation() ;
}

// callbackFn1 → callbackFn2 → callbackFn3 (終了) → callbackFn4 (実行されない) → callbackFn5 (実行されない)