jQuery Event.stopImmediatePropagation() 函数详解

Posted 2020-09-07

stopImmediatePropagation()函数用于阻止剩余的事件处理函数的执行，并防止当前事件在DOM树上冒泡。

根据DOM事件流机制，在元素上触发的大多数事件都会冒泡传递到该元素的所有祖辈元素上，如果这些祖辈元素上也绑定了相应的事件处理函数，就会触发执行这些函数。

使用stopImmediatePropagation()函数可以阻止当前事件向祖辈元素的冒泡传递，也就是说该事件不会触发执行当前元素的任何祖辈元素的任何事件处理函数。

此外，与event.stopPropagation()函数相比，stopImmediatePropagation()函数还会阻止该元素剩余的其他事件处理函数的执行。

此外，由于live()函数并不是将事件处理函数直接绑定到自己身上，而是"委托"绑定到祖辈元素上，由祖辈元素来触发执行。live()函数会先一次性冒泡到文档的顶部，然后为符合条件的元素触发事件。因此，stopImmediatePropagation()函数无法阻止live事件的冒泡。

同样地，delegate()函数也是"委托事件函数"，只有事件冒泡传递到"受委托"的祖辈元素才会被触发执行。因此，stopImmediatePropagation()函数无法阻止该元素到"受委托"的祖辈元素之间的事件冒泡。

该函数属于jQuery的Event对象。

语法

jQuery 1.3 新增该函数。

eventObject.stopImmediatePropagation( )

返回值

stopImmediatePropagation()函数没有返回值，也可以说返回值为undefined。

示例&说明

请参考下面这段html代码：

<p>段落文本内容
    <input type="button" value="点击" />
</p>

与event.stopImmediatePropagation()函数相关的jQuery示例代码如下：

// 为所有p元素绑定click事件
$("p").click( function(event){
    alert("p-click");
} );

// 为所有button元素的click事件绑定第一个事件处理函数
$(":button").click( function(event){
    alert("button-click-1");
    
    // 阻止事件冒泡到DOM树上，并阻止剩余的事件处理函数的执行
    // 只执行button-click-1，如果注释掉该行，将执行button-click-1、button-click-2和p-click
    // 如果换成event.stopPropagation() 将执行button-click-1和button-click-2
    event.stopImmediatePropagation();
} );

// 为所有button元素的click事件绑定第二个事件处理函数
$(":button").click( function(event){
    alert("button-click-2");
} );

该函数无法阻止live()函数的事件传递，也无法阻止delegate()函数的选择元素到"受委托"元素之间的事件传递。相关示例请参考event.stopPropagation()函数文档中最后部分的示例代码。

来自：http://www.365mini.com/page/jquery-event-stopimmediatepropagation.htm