# event.stopPropagation()

所属分类：事件 > 事件对象 英文文档：event.stopPropagation()

## event.stopPropagation()返回:

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

- #### 添加的版本: 1.0event.stopPropagation()

  - 这个方法不接受任何参数。

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

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

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

### Additional Notes:（其他注意事项：）

自从`.live()`方法处理事件一旦传播到文档的顶部，live事件是不可能停止传播的。同样地，`.delegate()` 事件将始终传播给其中包含的被委托元素； 元素上的事件将在被委托事件被调用的时候执行。因此，这些处理程序，可以调用`event.stopPropagation()`或者返回`false`防止委派处理程序冒泡。

## 例子:

#### Kill the bubbling on the click event.

1 2 3 4 |
    $("p").click(function(event){  event.stopPropagation();  // do something});