From 3803b428d0be4cb1ef0e729f66e9f7478a69220c Mon Sep 17 00:00:00 2001 From: allo Date: Thu, 10 Mar 2022 14:42:17 +0800 Subject: convert to md and sync with english version --- files/zh-cn/web/api/event/stoppropagation/index.md | 66 ++++++---------------- 1 file changed, 16 insertions(+), 50 deletions(-) (limited to 'files/zh-cn') diff --git a/files/zh-cn/web/api/event/stoppropagation/index.md b/files/zh-cn/web/api/event/stoppropagation/index.md index b769c50a6e..ec0e4ef6fb 100644 --- a/files/zh-cn/web/api/event/stoppropagation/index.md +++ b/files/zh-cn/web/api/event/stoppropagation/index.md @@ -11,66 +11,32 @@ tags: - 阻止冒泡事件 translation_of: Web/API/Event/stopPropagation --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

阻止捕获和冒泡阶段中当前事件的进一步传播。

+{{domxref("Event")}} 接口的 **`stopPropagation()`** 方法阻止捕获和冒泡阶段中当前事件的进一步传播。但是,它不能防止任何默认行为的发生;例如,对链接的点击仍会被处理。如果要停止这些行为,请参见 {{domxref("Event.preventDefault", "preventDefault()")}} 方法,它可以阻止事件触发后默认动作的发生。它也不能阻止附加到相同元素的相同事件类型的其它事件处理器,如果要阻止这些处理器的运行,请参见 {{domxref("Event.stopImmediatePropagation", "stopImmediatePropagation()")}} 方法。 -

但是,它不能防止任何默认行为的发生; 例如,对链接的点击仍会被处理。

+## 语法 -

如果要停止这些行为,请参见 preventDefault 方法,它可以阻止事件触发后默认动作的发生。

+```js +event.stopPropagation(); +``` -

语法

+### 参数 -
event.stopPropagation();
-
+None. -

参数

+### 返回值 -

None.

+None. -

返回值

+## 示例 -

undefined.

+参见[冒泡事件](/zh-CN/docs/Web/API/Document_Object_Model/Examples#example_5_event_propagation)。 -

例子

+## 规范 -

查看示例5: 事件传播 在示例一章中有关此方法和事件在DOM中传播的更详细示例。

+{{Specifications}} -

备注

+## 浏览器兼容性 -

查看 DOM 规范 中关于事件流的解释。 ( DOM Level 3 事件草案 有案例可参考。)

- -

preventDefault 是另外一个相关的方法,它可以阻止事件触发后默认动作的发生。

- -

规范

- - - - - - - - - - - - - - - - - - - - - - - - -
规范状态说明
{{SpecName("DOM4", "#dom-event-stoppropagation", "Event.stopPropagation()")}}{{Spec2("DOM4")}}
{{SpecName("DOM3 Events", "#widl-Event-stopPropagation", "Event.stopPropagation()")}}{{Spec2("DOM3 Events")}}
{{SpecName("DOM2 Events", "#Events-Event-stopPropagation", "Event.stopPropagation()")}}{{Spec2("DOM2 Events")}}初始定义
- -

浏览器兼容性

- -

{{Compat("api.Event.stopPropagation")}}

- -
+{{Compat}} -- cgit v1.2.3-54-g00ecf