event.stopPropagation()

event.stopPropagation()

描述: 防止事件冒泡到DOM树上,也就是不触发的任何前辈元素上的事件处理函数。

  • version added: 1.0event.stopPropagation()

我们可以用 event.isPropagationStopped() 来确定这个方法是否(在那个事件对象上)调用过了。

这个方法对 trigger() 来自定义的事件同样有效。

注意,这不会阻止同一个元素上的其它事件处理函数的运行。

Additional Notes:

  • 自从.live()方法处理事件一旦传播到文档的顶部,live事件是不可能停止传播的。同样地,.delegate() 事件将始终传播给其中包含的被委托元素;元素上的事件将在被委托事件被调用的时候执行。

Example:

灭掉click事件的冒泡。

$("p").click(function(event){
  event.stopPropagation();
  // do something
});  
jQuery 1.6 API 中文版Clove整理、修订