.dblclick() — обработчик двойного клика мышью

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

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

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

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

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

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

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

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

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

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

Чтобы вызвать событие вручную (без двойного клика по элементу), установим обработчик click на элемент с идентификатором other и вызовем событие 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.

1 комментарий

Оставить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *