首页 参考手册 笔记

jQuery 教程

jQuery triggerHandler() 方法

jQuery 事件方法 jQuery 事件方法

实例

触发 <input> 元素的 select 事件：

$("button").click(function() {
    $("input").triggerHandler("select");
});
尝试一下 »

定义和用法

triggerHandler() 方法触发被选元素上指定的事件。

该方法的返回的是事件处理函数的返回值，而不是具有可链性的 jQuery 对象。此外，如果没有处理程序被触发，则这个方法返回 undefined。

该方法与 trigger() 方法类似，不同的是 trigger() 也触发事件的默认行为（比如表单提交）。

与 trigger() 方法相比的不同之处:

  • 它不会引起事件（比如表单提交）的默认行为
  • .trigger() 会操作 jQuery 对象匹配的所有元素，而 .triggerHandler() 只影响第一个匹配元素。
  • 由 .triggerHandler() 创建的事件不会在 DOM 树中冒泡；如果目标元素不直接处理它们，则不会发生任何事情。

实例

triggerHandler() 与 .trigger() 比较：

$("#old").click(function() {
    $("input").trigger("focus");
});
$("#new").click(function() {
    $("input").triggerHandler("focus");
});
$("input").focus(function() {
    $("<span>Focused!</span>").appendTo("body").fadeOut(1000);
});
尝试一下 »

语法

$(selector).triggerHandler(event,param1,param2,...)

参数 描述
event 必需。规定指定元素上要触发的事件。
param1,param2,... 可选。传递到事件处理程序的额外参数。
额外参数对自定义事件特别有用。
实例

 更多实例

传递额外参数到自定义事件
如何传递额外参数到自定义事件处理程序。

trigger() 和 triggerHandler() 之间的不同
演示 trigger() 和 triggerHandler() 之间的不同。

jQuery 事件方法 jQuery 事件方法