triggerHandler( event, [data] ) Method

Description

The triggerHandler( event, [data] ) method triggers all bound event handlers on an element (for a specific event type) WITHOUT executing the browser's default actions, bubbling, or live events.

This method behaves very similarly to the trigger method, with two major exceptions −

First − No default browser actions are triggered, the triggered event does not bubble, and live events aren't triggered.
Second − The event is only triggered on the first element within the jQuery collection.

This method returns the return value of the triggered handler instead of a chainable jQuery object.

Syntax

Here is the simple syntax to use this method −

selector.triggerHandler( event, [data] )

Parameters

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

event − An event object or type to trigger.
data − This is an optional parameters and represents additional data to pass as arguments (after the event object) to the event handler.

Example

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

Live Demo

<html>
   <head>
      <title>The jQuery Example</title>
      <script type = "text/javascript" 
         src = "https://www.tutorialspoint.com/jquery/jquery-3.6.0.js">
      </script>
		
      <script type = "text/javascript" language = "javascript">
         $(document).ready(function() {

            $("#old").click(function(){
               $("input").trigger("focus");
            });
      
            $("#new").click(function(){
               $("input").triggerHandler("focus");
            });
      
            $("input").focus(function(){
               $("<span>Focused!</span>").appendTo("body").fadeOut(1000);
            });
				
         });
      </script>
   </head>
	
   <body>
      <button id = "old">.trigger("focus")</button>
      <button id = "new">.triggerHandler("focus")</button><br/><br/>
		
      <input type = "text" value = "To Be Focused"/>
   </body>
</html>

This will produce following result −

jquery-events.htm