dblclick event — jQuery

Привяжите обработчик событий к событию "dblclick" или вызовите это событие для элемента.

Содержание:

.on( "dblclick" [, eventData ], handler )
- .on( "dblclick" [, eventData ], handler )
.trigger( "dblclick" )
- .trigger( "dblclick" )

.on( "dblclick" [, eventData ], handler )Возвращает: jQuery

Описание: Привязывает обработчик событий к событию "dblclick".

версия добавлена: 1.7.on( "dblclick" [, eventData ], handler )
- "dblclick"
  
  Тип: строка
  
  Строка "dblclick".
- eventData
  
  Тип: Любой тип
  
  Объект, содержащий данные, которые будут переданы обработчику события.
- handler
  
  Тип: Функция( Событие eventObject )
  
  Функция, которая выполняется каждый раз, когда событие срабатывает.

Эта страница описывает событие dblclick. Для устаревшего метода .dblclick(), см. .dblclick().

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

<div id="target">
  Double-click here
</div>
<div id="other">
  Trigger the handler
</div>

Рисунок 1 - Иллюстрация отображенного HTML

Обработчик событий может быть привязан к любому <div>:

$( "#target" ).on( "dblclick", function() {
  alert( "Handler for `dblclick` called." );
} );

Теперь двойной щелчок по этому элементу отображает сообщение об ошибке:

Обработчик для `dblclick` вызван.

Чтобы вызвать событие вручную, вызовите .trigger( "dblclick" ):

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

После выполнения этого кода, (одиночные) щелчки по Запустить обработчик также приведут к появлению сообщения об ошибке.

Событие dblclick срабатывает только после этой точной последовательности событий:

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

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

Примеры:

Чтобы привязать сообщение "Hello World!" к событию dblclick для каждого абзаца на странице:

$( "p" ).on( "dblclick", function() {
  alert( "Hello World!" );
} );

Двойной щелчок для переключения цвета фона.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>on 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-3.7.0.js"></script>
</head>
<body>
 
<div></div>
<span>Double click the block</span>
 
<script>
var divdbl = $( "div" ).first();
divdbl.on( "dblclick", function() {
  divdbl.toggleClass( "dbl" );
} );
</script>
 
</body>
</html>

Демонстрация:

.trigger( "dblclick" )Возвращает: jQuery

Описание: Вызывает событие "dblclick" для элемента.

версия добавлена: 1.0.trigger( "dblclick" )
- "dblclick"
  
  Тип: строка
  
  Строка "dblclick".

См. описание для .on( "dblclick", ... ).

событие dblclick

Содержание:

.on( "dblclick" [, eventData ], handler )Возвращает: jQuery

версия добавлена: 1.7.on( "dblclick" [, eventData ], handler )

Примеры:

Демонстрация:

.trigger( "dblclick" )Возвращает: jQuery

версия добавлена: 1.0.trigger( "dblclick" )