.dblclick() – устанавливает обработчик двойного “клика” мышью по элементу, либо, запускает это событие.

Метод имеет три варианта использования.

.dblclick( handler )

• handler – функция, которая будет установлена в качестве обработчика.

.dblclick( [eventData ], handler )

• eventData – объект содержащий данные, для передачи в обработчик. Должны быть представлены в формате {fName1:value1, fName2:value2, …};
• handler – функция, которая будет установлена в качестве обработчика.

.dblclick()

Вызывает событие dblclick, у выбранных элементов страницы.

В первых двух вариантах, этот метод является сокращенной версией .on( "dblclick", handler ), а в третьем – .trigger( “dblclick” ).

Событие dblclick отправляется элементу, когда пользователь выполняет двойной щелчок на нем.  Событие сработает на любом html-элементе, на который оно может быть назначено.

Для примера рассмотрим следующий html-код:

<div id="target">
  Выполните двойной клик по этому элементу
</div>
<div id="other">
  Запустить обработчик
</div>

Установим обработчик события dblclick элементу с идентификатором target:

$( "#target" ).dblclick(function() {
  alert( "Вызвано событие .dblclick()" );
});

Теперь, при клике по этому элементу (target) мы увидим сообщение “Вызвано событие .dblclick()”.

Чтобы вызвать событие вручную (без двойного клика по элементу), установим обработчик click на элемент с идентификатором other и вызовем событие dblclick без аргументов:

$( "#other" ).click(function() {
  $( "#target" ).dblclick();
});

Кликнув (1 раз) мышью в элемент с идентификатором other мы также увидим сообщение “Вызвано событие .dblclick()”.

Событие dblclick запускается только после выполнения следующей цепочки:

1. Кнопка мыши нажата, когда указатель находится внутри элемента.
2. Кнопка мыши отпущена, когда указатель находится внутри элемента.
3. Кнопка мыши снова нажата, когда указатель находится внутри элемента, в пределах временного окна, которое зависит от системы.
4. Кнопка мыши отпущена, когда указатель находится внутри элемента.

Не рекомендуется устанавливать обработчики событий click и dblclick для одного и того же элемента. Последовательность запускаемых событий варьируется от браузера к браузеру, причем некоторые вызывают оба события, а другие – только одно. Чувствительность к двойному клику (максимальное время между кликами, определяемое как двойной клик) может варьироваться в зависимости от операционной системы, браузера и часто настраивается пользователем.

Дополнительные замечания

Поскольку метод .dblclick() является сокращенной версией .on( "dblclick", handler ), он может быть удален с помощью .off( "dblclick" ).

Пример

See the Pen oJOdyd by Aleksei (@AmateR) on CodePen.