jQuery метод .dblclick()
Определение и применение
jQuery метод .dblclick() привязывает JavaScript обработчик событий dblclick (двойной клик левой
кнопкой мыши), или запускает это событие на выбранный элемент.
Обращаю Ваше внимание на то, что следующие условия обязательно должны быть выполнены, чтобы событие "dblclick" сработало:
- Левая кнопка мыши нажата, когда курсор находился внутри элемента.
- Левая кнопка мыши отпущена пока курсор находится внутри элемента.
- Левая кнопка мыши нажата повторна пока курсор находится внутри элемента. Повторный клик левой кнопки мыши должен быть сделан в определенное временное окно, которое задается операционной системой пользователя.
- Левая кнопка мыши отпущена повторно пока курсор находится внутри элемента.
jQuery синтаксис:
Синтаксис 1.0:
$( selector ).dblclick() // метод используется без параметров
$( selector ).dblclick( handler )handler - Function( Event eventObject )
Синтаксис 1.4.3:
$( selector ).dblclick( eventData, handler )eventData - Anything
handler - Function( Event eventObject )
Обращаю Ваше внимание, что метод .dblclick(), используемый вместе с функцией, переданной в качестве параметра (handler) является, короткой записью метода .on(), а без параметра является короткой записью метода .trigger():
$( selector ).on( "dblclick", handler )
$( selector ).trigger( "dblclick" )
Добавлен в версии jQuery
1.0 (синтаксис обновлен в версии 1.4.3)Значения параметров
| Параметр | Описание |
|---|---|
| eventData | Объект, содержащий данные, которые будут переданы в обработчик событий. |
| handler |
Функция, которая будет выполнена каждый раз, когда событие срабатывает. Функция в качестве параметра может
принимать объект Event.
|
Пример старого кода
Двойной клик: .dblclick()
Нажмите , затем выполните действие из пояснения. Измените JavaScript и запустите пример ещё раз. В редакторе используется jQuery 4.0.0.
index.html
<button>Клик</button>
<div style="border: 1px solid green">Элемент div</div>
main.js
$(document).ready(function () {
$('button').click(function () {
$('div').dblclick()
})
$('div').dblclick(function () {
$('div').toggle()
})
})
Нажмите , чтобы запустить пример.
В этом примере с использованием jQuery метода .dblclick() мы при нажатии на элемент
<button>
(кнопка) вызываем событие "dblclick" на элементе
<div>. Самому элементу
<div>
задаем, что при срабатывании события "dblclick" на элементе выполнить функцию, которая с использованием метода
.toggle()
отобразит, или скроет элемент.
Обратите внимание, что если мы вызываем напрямую событие "dblclick" на элемент
<div>, то мы его можем только скрыть, по той причине, что напрямую кликнуть по скрытому элементу нельзя, но мы можем опять
отобразить этот элемент кликнув по кнопке, которая симулирует клик по этому элементу.