## .dblclick( handler )Returns: jQuery

Description: Bind an event handler to the "dblclick" JavaScript event, or trigger that event on an element.

- #### version added: 1.0.dblclick( handler )

  - handler
    Type: Function( Event eventObject )
    A function to execute each time the event is triggered.

- #### version added: 1.4.3.dblclick( [eventData ], handler )

  - eventData
    Type: Anything
    An object containing data that will be passed to the event handler.
  - handler
    Type: Function( Event eventObject )
    A function to execute each time the event is triggered.

- #### version added: 1.0.dblclick()

  - This signature does not accept any arguments.

This method is a shortcut for `.on( "dblclick", handler )` in the first two variations, and `.trigger( "dblclick" )` in the third. The `dblclick` event is sent to an element when the element is double-clicked. Any HTML element can receive this event. For example, consider the HTML:

1 2 3 4 5 6 |
    <div id="target">  Double-click here</div><div id="other">  Trigger the handler</div>

Figure 1 - Illustration of the rendered HTML

The event handler can be bound to any `<div>`:

1 2 3 |
    $( "#target" ).dblclick(function() {  alert( "Handler for .dblclick() called." );});

Now double-clicking on this element displays the alert:

`Handler for .dblclick() called.`

To trigger the event manually, call `.dblclick()` without an argument:

1 2 3 |
    $( "#other" ).click(function() {  $( "#target" ).dblclick();});

After this code executes, (single) clicks on `Trigger the handler` will also alert the message.

The `dblclick` event is only triggered after this exact series of events:

- The mouse button is depressed while the pointer is inside the element.
- The mouse button is released while the pointer is inside the element.
- The mouse button is depressed again while the pointer is inside the element, within a time window that is system-dependent.
- The mouse button is released while the pointer is inside the element.

It is inadvisable to bind handlers to both the `click` and `dblclick` events for the same element. The sequence of events triggered varies from browser to browser, with some receiving two `click` events before the `dblclick` and others only one. Double-click sensitivity (maximum time between clicks that is detected as a double click) can vary by operating system and browser, and is often user-configurable.

### Additional Notes:

- As the `.dblclick()` method is just a shorthand for `.on( "dblclick", handler )`, detaching is possible using `.off( "dblclick" )`.

## Examples:

To bind a "Hello World!" alert box to the dblclick event on every paragraph on the page:

1 2 3 |
    $( "p" ).dblclick(function() {  alert( "Hello World!" );});

Double click to toggle background color.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 |
    <!doctype html><html lang="en"><head>  <meta charset="utf-8">  <title>dblclick demo</title>  <style>  div {    background: blue;    color: white;    height: 100px;    width: 150px; }  div.dbl {    background: yellow;    color: black;  }  </style>  <script src="https://code.jquery.com/jquery-1.10.2.js"></script></head><body> <div></div><span>Double click the block</span> <script>var divdbl = $( "div:first" );divdbl.dblclick(function() {  divdbl.toggleClass( "dbl" );});</script> </body></html>

#### Demo: