.die()

Categories: Deprecated > Deprecated 1.7 | Events > Event Handler Attachment | Removed

.die()Returns: jQueryversion deprecated: 1.7, removed: 1.9

Description: Remove event handlers previously attached using .live() from the elements.

  • version added: 1.4.1.die()

    • This signature does not accept any arguments.

  • version added: 1.3.die( eventType [, handler ] )

    • eventType
      Type: String
      A string containing a JavaScript event type, such as click or keydown.
    • handler
      Type: String
      The function that is no longer to be executed.

  • version added: 1.4.3.die( events )

    • events
      A plain object of one or more event types, such as click or keydown and their corresponding functions that are no longer to be executed.

Note: This API has been removed in jQuery 1.9; please use on() instead.

Any handler that has been attached with .live() can be removed with .die(). This method is analogous to calling .off() with no arguments, which is used to remove all handlers attached with .on(). See the discussions of .live() and .off() for further details.

If used without an argument, .die() removes all event handlers previously attached using .live() from the elements.

As of jQuery 1.7, use of .die() (and its complementary method, .live()) is not recommended. Instead, use .off() to remove event handlers bound with .on()

Note: In order for .die() to function correctly, the selector used with it must match exactly the selector initially used with .live().

Examples:

To unbind all live events from all paragraphs, write:

1
 
$( "p" ).die();

To unbind all live click events from all paragraphs, write:

1
 
$( "p" ).die( "click" );

To unbind just one previously bound handler, pass the function in as the second argument:

1
2
3
4
5
6
7
8
9
 
var foo = function() {
  // Code to handle some kind of event
};
 
// Now foo will be called when paragraphs are clicked
$( "p" ).live( "click", foo );
 
// Now foo will no longer be called
$( "p" ).die( "click", foo );