From ed23c809d50f8653e5be65d907c6b9b2453262fc Mon Sep 17 00:00:00 2001 From: allo Date: Sun, 28 Aug 2022 22:03:07 +0800 Subject: [PATCH 1/2] sync with english version for CustomEvent --- files/zh-cn/web/api/customevent/index.md | 105 ++++------------------- 1 file changed, 17 insertions(+), 88 deletions(-) diff --git a/files/zh-cn/web/api/customevent/index.md b/files/zh-cn/web/api/customevent/index.md index 0a04be33a3e3dc..df8a6dc6d4101c 100644 --- a/files/zh-cn/web/api/customevent/index.md +++ b/files/zh-cn/web/api/customevent/index.md @@ -4,106 +4,30 @@ slug: Web/API/CustomEvent --- {{APIRef("DOM")}} -`CustomEvent` 事件是由程序创建的,可以有任意自定义功能的事件。 +`CustomEvent` 接口表示由程序出于某个目的而创建的事件。 {{AvailableInWorkers}} +{{InheritanceDiagram}} + ## 构造函数 -**{{domxref("CustomEvent.CustomEvent", "CustomEvent()")}}** 创建一个自定义事件。 +- {{domxref("CustomEvent.CustomEvent", "CustomEvent()")}} + - : 创建一个 `CustomEvent`。 ## 属性 -**{{domxref("CustomEvent.detail")}} {{readonlyinline}} 任何时间初始化时传入的数据** - -_此接口从父接口继承属性,_ {{domxref("Event")}}: +_此接口从父接口 {{domxref("Event")}} 继承属性。_ -{{Page("/zh-CN/docs/Web/API/Event", "Properties")}} +- {{domxref("CustomEvent.detail")}} {{ReadOnlyInline}} + - : 返回在初始化事件时传入的任何数据。 ## 方法 -- {{domxref("CustomEvent.initCustomEvent()")}} {{deprecated_inline}} - - : 初始化一个 `CustomEvent 对象。如果事件已经被触发,这个方法将不会起任何作用。` - -_此接口从父接口继承方法,_ {{domxref("Event")}}: - -{{Page("/zh-CN/docs/Web/API/Event", "Methods")}} - -## 方法概述 - -``` -void initCustomEvent(in DOMString type, in boolean canBubble, in boolean cancelable, in any detail); -``` - -## 属性 - -| 属性 | 类型 | 描述 | -| -------- | ----- | -------------------------- | -| `detail` | `any` | 当事件初始化时传递的数据。 | - -## 方法 - -### initCustomEvent() - -初始化一个自定义事件的方式和初始化一个标准 DOM 事件的方式非常相似。 - -``` -void initCustomEvent( - in DOMString type, - in boolean canBubble, - in boolean cancelable, - in any detail -); -``` +_此接口从父接口 {{domxref("Event")}} 继承方法。_ -#### 参数 - -- `type` - - : 事件的类型名称。 -- `canBubble` - - : 一个布尔值,表明该事件是否会冒泡。 -- `cancelable` - - : 一个布尔值,表明该事件是否可以被取消。 -- `detail` - - : 当事件初始化时传递的数据。 - -## 构造函数 - -[DOM4 规范](http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html) 添加了对 `CustomEvent` 构造函数的支持。 - -``` -CustomEvent( - DOMString type, - optional CustomEventInit eventInitDict -) -``` - -### 参数 - -- `type` - - : 事件的类型名称。 -- `eventInitDict` - - : 一个提供事件的配置信息对象。查看[CustomEventInit](#CustomEventInit)了解更多详情。 - -#### CustomEventInit - -- `bubbles` - - : 一个布尔值,表明该事件是否会冒泡。 -- `cancelable` - - : 一个布尔值,表明该事件是否可以被取消。 -- `detail` - - : 当事件初始化时传递的数据。 - -### CustomEvent 用法示例 - -```js -// 添加一个适当的事件监听器 -obj.addEventListener("cat", function(e) { process(e.detail) }) - -// 创建并分发事件 -var event = new CustomEvent("cat", {"detail":{"hazcheeseburger":true}}) -obj.dispatchEvent(event) -``` +- {{domxref("CustomEvent.initCustomEvent()")}} {{deprecated_inline}} + - : 初始化一个 `CustomEvent` 对象。如果事件已经被触发,这个方法将不会起任何作用。 ## 规范 @@ -111,4 +35,9 @@ obj.dispatchEvent(event) ## 浏览器兼容性 -{{Compat("api.CustomEvent")}} +{{Compat}} + +## 参见 + +- {{domxref("Window.postMessage()")}} +- [创建和触发事件](/zh-CN/docs/Web/Events/Creating_and_triggering_events) From 30ccdc16235f3b138d2f366edc8bc4d5f4d81f1b Mon Sep 17 00:00:00 2001 From: A1lo Date: Sun, 28 Aug 2022 22:10:48 +0800 Subject: [PATCH 2/2] Update files/zh-cn/web/api/customevent/index.md --- files/zh-cn/web/api/customevent/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/api/customevent/index.md b/files/zh-cn/web/api/customevent/index.md index df8a6dc6d4101c..9f8a0aa18f5dda 100644 --- a/files/zh-cn/web/api/customevent/index.md +++ b/files/zh-cn/web/api/customevent/index.md @@ -13,7 +13,7 @@ slug: Web/API/CustomEvent ## 构造函数 - {{domxref("CustomEvent.CustomEvent", "CustomEvent()")}} - - : 创建一个 `CustomEvent`。 + - : 创建一个新的 `CustomEvent`。 ## 属性