JavaScript. Подробное руководство, 6-е издание

Методу unbind можно также передавать объект в единственном аргументе. В этом случае метод unbind будет вызываться рекурсивно для каждого свойства объекта. Имена свойств этого объекта должны определять типы событий, а значения -функции обработчиков:

  $('а').unbind({ // Удалить конкретные обработчики событий mouseover и mouseout
   mouseover: mouseoverHandler.
   mouseout: mouseoutHandle г
  });

Наконец, существует еще один способ вызова метода unbind. Если передать ему объект Event, созданный библиотекой jQuery, он удалит обработчики событий, которым будет передано это событие. Вызов unbind(ev) эквивалентен вызову unbind(ev.type, ev.handler).

19.4.6. Возбуждение событий

Зарегистрированные обработчики событий будут вызываться автоматически, когда пользователь начнет использовать мышь или клавиатуру или когда будут возникать события других типов. Однако иногда бывает полезно генерировать события вручную. Проще всего сделать это, вызвав один из простых методов регистрации обработчиков (такой как click или mouseover) без аргументов. Подобно многим методам объекта jQuery, которые могут играть роль методов чтения и записи, эти методы регистрируют обработчики событий, когда вызываются с аргументами, и запускают их, когда вызываются без аргументов. Например:

  $("#my_form").submit; // Будет действовать, как если бы пользователь щелкнул
   // на кнопке отправки формы

Метод submit() в инструкции выше синтезирует объект Event и запустит все обработчики событий, которые были зарегистрированы для события «submit». Если ни один из этих обработчиков не вернет false или не вызовет метод preventDefault объекта Event, форма действительно будет отправлена. Обратите внимание, что события будут всплывать, даже если сгенерировать их вручную, как в данном примере. Это означает, что возбуждение события в множестве выбранных элементов может также привести к вызову обработчиков событий в предках этих элементов.

Важно отметить, что методы объекта jQuery, генерирующие события, будут запускать любые обработчики событий, зарегистрированные методами объекта jQuery, а также обработчики, объявленные в HTML-атрибутах или свойствах объектов Element, таких как onsubmit. Но с их помощью невозможно вручную запустить обработчики событий, зарегистрированные методом addEventListener или attachEvent (однако эти обработчики по-прежнему будут вызываться при возникновении настоящих событий).

Отметьте также, что механизм возбуждения событий в библиотеке jQuery является синхронным - в нем не используется очередь событий. Когда событие генерируется вручную, обработчики событий будут вызваны немедленно, до того как метод, возбудивший событие, вернет управление. Если вы генерируете событие «click» и один из запущенных обработчиков сгенерирует событие «submit», все обработчики события «submit» будут вызваны до того, как будет вызван следующий обработчик события «click».

Методы, такие как submit, удобно использовать для связывания и возбуждения событий; но как библиотека jQuery определяет более обобщенный метод bind, так же она определяет и более обобщенный метод trigger. Обычно при вызове в первом аргументе методу trigger передается строка с типом события, и он запускает обработчики, зарегистрированные для этого типа во всех выбранных элементах в объекте jQuery. То есть вызов submit в примере выше эквивалентен вызову:

  $("#my_form").trigger("submit");

В отличие от методов bind и unbind, в вызове метода trigger нельзя указать более одного типа события в первом аргументе. Однако, подобно методам bind и unbind, он позволяет указывать пространства имен возбуждаемых событий» чтобы запустить только обработчики, зарегистрированные для этого пространства имен. Если потребуется запустить только обработчики событий, не привязанные ни к какому пространству имен, следует добавить в строку с типом события восклицательный знак. Обработчики, зарегистрированные посредством свойств, таких как onclick, считаются обработчиками, не привязанными к какому-либо пространству имен:

  $("button").trigger("click.ns1"); // Запустит обработчики в пространстве имен
  $("button").trigger("click!"); // Запустит обработчики, не привязанные
  // к какому-либо пространству имен

Вместо строки с типом события в первом аргументе методу trigger можно передать объект Event (или любой другой объект, имеющий свойство type). Свойство type будет определять, какие обработчики должны запускаться. Если передать объект Event библиотеки jQuery, этот объект будет передан обработчикам. Если передать простой объект, автоматически будет создан новый объект Event библиотеки jQuery и в него будут добавлены свойства объекта, переданного методу. Это самый простой способ передать обработчикам событий дополнительные данные:

  // Обработчик onclick элемента buttonl генерирует то же событие для button2
  $('flbuttonl').click(function(e) { $('flbutton2').trigger(e); });

  // Добавит дополнительные свойства в объект события при возбуждении события
  $('flbuttonl').trigger({type: 'click', synthetic:true});

  // Этот обработчик проверяет дополнительные свойства, чтобы отличить
  // настоящее событие от искусственного
  $('flbuttonl').click(function(e) { if (е.synthetic) (...) }):

Передать дополнительные данные обработчикам при возбуждении событий вручную можно также с помощью второго аргумента метода trigger. Значение, переданное методу trigger во втором аргументе, будет передаваться во втором аргументе всем запущенным обработчикам событий. Если во втором аргументе передать массив, каждый его элемент будет передан обработчикам в виде отдельного аргумента:

  $('flbuttonl').trigger("click", true); // Передать единственный дополнительный аргумент
  $('flbuttonl').trigger("click", [х,у,z]); // Передать три дополнительных аргумента

Иногда может потребоваться запустить все обработчики события данного типа, независимо от того, к какому элементу документа они привязаны. Для этого можно выбрать все элементы вызовом $('*') и вызвать метод trigger относительно результата, но это решение весьма неэффективно. Вместо того чтобы возбуждать событие в глобальном масштабе, можно вызвать вспомогательную функцию jQuery.event.trigger. Эта функция принимает те же аргументы, что и метод trigger, и эффективно запускает обработчики событий указанного типа, имеющиеся во всем документе. Обратите внимание, что «глобальные события», возбуждаемые таким способом, не всплывают, и при этом запускаются только обработчики событий, зарегистрированные с использованием методов объекта jQuery (обработчики, зарегистрированные с помощью свойств модели DOM, не запускаются).