jQuery - stopPropagation() Method


Advertisements

Description

The stopPropagation() method stops the bubbling of an event to parent elements, preventing any parent handlers from being notified of the event.

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

Syntax

Here is the simple syntax to use this method −

event.stopPropagation() 

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. This example demonstrate how you can prevent other event handlers from being called −

<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("This is : " + $(this).text());
               // Comment the following to see the difference
               event.stopPropagation();
            });
         });
      </script>
		
      <style>
         div{ margin:10px;padding:12px; border:2px solid #666; width:160px;}
      </style>
   </head>
	
   <body>
      <p>Click on any box to see the effect:</p>
		
      <div id = "div1" style = "background-color:blue;">
         OUTER BOX
         <div id = "div2" style = "background-color:red;">
            INNER BOX
         </div> 
      </div>
   </body>
</html>

This will produce following result −

jquery-events.htm
Advertisements