[Функция] triggerHandler(event, data)
Раздел "Events"
Специфичный метод, запускающий все связанные обработчики событий с элементами (для особого типа события) БЕЗ выполнения действий браузера по умолчанию и без всплывания событий.
triggerHandler(event, data)
1.0
type: инициируемый тип события
data: дополниетльные данные, передаваемые в качестве аргументов (после события объекта) к обработчику
Данная функция ведёт себя подобно функции trigger(), с двумя важными исключениями:
Во первых действия браузера, исполняемые по умолчанию, не запускаются.
Во-вторых, событие запускается только для первого элемента в jQuery коллекции. Этот метод возвращает обратную переменную запущенного обработчика, взамен объекта jQuery. Также, если jQuery коллекция пуста, данная функция вернёт 'undefined'.
Пример:
Если вы вызовете .triggerHandler() для события focus как действия браузера по умолчанию, оно не произойдёт, только обработчик событий, связанный с событием focus запускается.
"HTML"
<button id="old">.trigger("focus")</button>
<button id="new">.triggerHandler("focus")</button><br/><br/>
<input type="text" value="To Be Focused"/>
"Живой пример jQuery"
Версия jQuery 1.4.2
Документ создан 2010-08-21