Справочник API
.click() в jQuery
Содержание статьи
-
Категории: Events › Mouse Events
Устанавливает (или вызывает) обработчики JavaScript события click (щелчок - последовательно нажата и отпущена кнопка мыши на одном и том же участке экрана) для всех элементов набора jQuery.
Синтаксис и описание:
Добавлено в jQuery 1.0.click( [handler( eventObject )] )
Объявляет функцию handler() обработчиком JavaScript события click для всех элементов набора jQuery. Это сокращенный вариант функции .bind() :
.bind('click', handler)
Если необязательный параметр handler() опущен, то искусственно вызывает все обработчики события click, установленные во всех соответствующих элементах. Также искусственно создает объект события Event и передает его обработчикам. Это укороченный вариант метода .trigger() :
.trigger('click')
Возвращаемое значение: (объект) Набор jQuery.
Параметры:
handler( [eventObject] ) – Необязательный параметр - функция, объявляемая обработчиком JavaScript события click. В качестве единственного параметра она получает eventObject (экземпляр объекта Event). Контекст this вызова функции ссылается на текущий элемент.
function handler(eventObject) {
this; // текущий DOM-элемент.
}
-
Примечание:
Событие click - (Щелчок) Была последовательно нажата (событие mousedown) и отпущена (событие mouseup) кнопка мыши на одном и том же участке экрана. Следует за событием mouseup. (Актуально для большинства элементов.)
-
Примечание:
Действие браузера по умолчанию (например, переход по ссылке) можно предотвратить путем возвращения false функцией обработчиком.
-
Примечание:
Команда .click() без параметров не приводит к возникновению настоящего события 'click'. Она лишь запускает обработчики данного JS события. При этом свойство target искусственно сгенерированного экземпляра Event содержит ссылку на элемент, на котором установлен обработчик.
Примеры:
-
Установить обработчик события click на всех элементах <img> на странице, который вычисляет координаты указателя мыши при щелчке.
При клике на параграфе <p> будет запускаться обработчик первого изображения, а т.к. в этом случае экземпляр объекта события создается искусственно (без возникновения реального события click), то его свойства pageX и pageY (координаты события от мыши относительно начала координат документа) не будут иметь значений.
<img src="img/target1.gif" id="targ1" vspace="20" hspace="10" align="left" /> <img src="img/target2.gif" id="targ2" vspace="20" hspace="10" /> <p>Вызвать обработчик события click для первого изображения</p> <script type="text/javascript"> $('img').click(function(event) { alert('Координаты курсора мыши в ' + event.target.tagName + '#' + event.target.id + ' (' + event.pageX + ', ' + event.pageY + ')'); }); $('p').click(function() { $('img:first').click(); }); </script>Демонстрация примера:
Статьи по теме: