www.jQueryBook.ru - jQuery документация

 

Сегодня: 06 декабря 2016 года, Вторник
Раздел API на стадии наполнения...

 

 

 

  • Категории: EventsMouse Events

    .click()

    Устанавливает (или вызывает) обработчики 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-элемент.
                }
  1. Примечание:

    Событие click - (Щелчок) Была последовательно нажата (событие mousedown) и отпущена (событие mouseup) кнопка мыши на одном и том же участке экрана. Следует за событием mouseup. (Актуально для большинства элементов.)


  2. Примечание:

    Действие браузера по умолчанию (например, переход по ссылке) можно предотвратить путем возвращения false функцией обработчиком.


  3. Примечание:

    Команда .click() без параметров не приводит к возникновению настоящего события 'click'. Она лишь запускает обработчики данного JS события. При этом свойство target искусственно сгенерированного экземпляра Event содержит ссылку на элемент, на котором установлен обработчик.


Примеры:

  1. Установить обработчик события 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>


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



[ наверх ]










 




Справочник по jQuery JavaScript API на русском языке