stopImmediatePropagation() Method


Advertisements

Description

The stopImmediatePropagation() method stops the rest of the handlers from being executed. This method also stops the bubbling by calling event.stopPropagation().

You can use event.isImmediatePropagationStopped() to know whether this method was ever called (on that event object).

Syntax

Here is the simple syntax to use this method −

event.stopImmediatePropagation() 

Parameters

Here is the description of all the parameters used by this method −

  • NA

Example

Following is a simple example a simple showing the usage of this method −

<html>
   <head>
      <title>The jQuery Example</title>
      <script type = "text/javascript" 
         src = "https://ajax.googleapis.com/ajax/libs/jquery/2.1.3/jquery.min.js">
      </script>
		
      <script type = "text/javascript" language = "javascript">
         $(document).ready(function() {
			
            $("div").click(function(event){
               alert("1 - This is : " + $(this).text());
               // Comment the following to see the effect.
               event.stopImmediatePropagation();
            });
				
            // This won't be executed.
            $("div").click(function(event){
               alert("2 - This is : " + $(this).text());
            });
				
         });
      </script>
		
      <style>
         div{ margin:10px;padding:12px; border:2px solid #666; width:160px;}
      </style>
   </head>
	
   <body>
      <p>Click on any box to see the result:</p>
		
      <div id = "div1" style = "background-color:blue;">
         BOX 1
      </div>
		
      <div id = "div2" style = "background-color:red;">
         BOX 2
      </div> 
   </body>
</html>

This will produce following result −

jquery-events.htm
Advertisements