Skip to content

Commit

Permalink
AutoCorrect files/zh-cn/web/api/event/
Browse files Browse the repository at this point in the history
  • Loading branch information
huacnlee authored and yin1999 committed Jun 2, 2022
1 parent f7fa158 commit 28ccb8a
Show file tree
Hide file tree
Showing 17 changed files with 66 additions and 66 deletions.
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/event/bubbles/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,17 +5,17 @@
---
<p>{{ ApiRef() }}</p>
<h3 id="Summary" name="Summary">概述</h3>
<p>返回一个布尔值,表明当前事件是否会向DOM树上层元素冒泡.</p>
<p>返回一个布尔值,表明当前事件是否会向 DOM 树上层元素冒泡。</p>
<h3 id="语法">语法</h3>
<pre><em>var bool</em> = event.bubbles;
</pre>
<h3 id="Notes" name="Notes">备注</h3>
<p>一些特定的事件类型会冒泡.这时,该事件对象的<code>bubbles</code>属性为<code>true</code>. 你可以检查该属性的值来判断一个事件对象是否冒泡.</p>
<p>一些特定的事件类型会冒泡。这时,该事件对象的<code>bubbles</code>属性为<code>true</code>. 你可以检查该属性的值来判断一个事件对象是否冒泡</p>
<h3 id="Example" name="Example">例子</h3>
<pre class="brush: js"> function goInput(e) {
// 检查事件对象是否冒泡
if (!e.bubbles) {
// 如果不冒泡,则手动传递事件
// 如果不冒泡则手动传递事件
passItOn(e);
}
// 如果冒泡的话
Expand Down
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/event/cancelbubble/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
---
<p>{{APIRef("DOM Events")}} </p>

<p><code><strong>Event.cancelBubble</strong></code> 属性是 {{domxref("Event.stopPropagation()")}}的一个曾用名。在从事件处理程序返回之前将其值设置为true可阻止事件的传播</p>
<p><code><strong>Event.cancelBubble</strong></code> 属性是 {{domxref("Event.stopPropagation()")}}的一个曾用名。在从事件处理程序返回之前将其值设置为 true 可阻止事件的传播</p>

<h2 id="Syntax" name="Syntax">语法</h2>

Expand All @@ -28,7 +28,7 @@ <h2 id="用例">用例</h2>

<h2 id="规范">规范</h2>

<p><em>这个属性的规范并未统一.</em> 因为他还有其他标准 W3C版: <a href="http://www.w3.org/TR/1999/WD-DOM-Level-2-19990304/events.html#attribute-cancelBubble">an old Working Draft of W3C DOM Level 2</a>. 微软版: <a href="https://msdn.microsoft.com/en-us/library/ms533545(v=vs.85).aspx">description of it on MSDN</a>.</p>
<p><em>这个属性的规范并未统一</em> 因为他还有其他标准 W3C 版: <a href="http://www.w3.org/TR/1999/WD-DOM-Level-2-19990304/events.html#attribute-cancelBubble">an old Working Draft of W3C DOM Level 2</a>. 微软版: <a href="https://msdn.microsoft.com/en-us/library/ms533545(v=vs.85).aspx">description of it on MSDN</a>.</p>

<h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容</h2>

Expand Down
14 changes: 7 additions & 7 deletions files/zh-cn/web/api/event/composedpath/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -16,17 +16,17 @@ <h2 id="语法"><strong>语法</strong></h2>

<h3 id="参数">参数</h3>

<p>.</p>
<p></p>

<h3 id="返回值">返回值</h3>

<p>一个 {{domxref("EventTarget")}}对象数组,表示将在其上调用事件侦听器的对象。</p>

<h2 id="例子"><strong>例子</strong></h2>

<p>在我们的 composed-composed-path 例子中,我们定义了两个自定义元素,<code>&lt;open-shadow&gt;</code> 和 <code>&lt;closed-shadow&gt;,</code>两 个全都调用了它们文本属性的内容然后作为<code>&lt;p&gt;</code>  元素的文本内容将它们插入到元素的影子DOM中。两者之间唯一的区别是它们影子的根结点是在它们的模式被分别设置成<code>open</code> 和 <code>closed</code> 的情况下连接的。</p>
<p>在我们的 composed-composed-path 例子中,我们定义了两个自定义元素,<code>&lt;open-shadow&gt;</code> 和 <code>&lt;closed-shadow&gt;,</code>两 个全都调用了它们文本属性的内容然后作为<code>&lt;p&gt;</code>  元素的文本内容将它们插入到元素的影子 DOM 中。两者之间唯一的区别是它们影子的根结点是在它们的模式被分别设置成<code>open</code> 和 <code>closed</code> 的情况下连接的。</p>

<p>第一个定义就像这样, 比如:</p>
<p>第一个定义就像这样,比如:</p>

<pre class="brush: js">customElements.define('open-shadow',
class extends HTMLElement {
Expand All @@ -42,23 +42,23 @@ <h2 id="例子"><strong>例子</strong></h2>
}
});</pre>

<p>然后我们在我们的页面中插入其中一个元素:</p>
<p>然后我们在我们的页面中插入其中一个元素</p>

<pre class="brush: html">&lt;open-shadow text="I have an open shadow root"&gt;&lt;/open-shadow&gt;
&lt;closed-shadow text="I have a closed shadow root"&gt;&lt;/closed-shadow&gt;</pre>

<p>然后在 <code>&lt;html&gt;</code> 元素中插入一个鼠标点击事件:</p>
<p>然后在 <code>&lt;html&gt;</code> 元素中插入一个鼠标点击事件</p>

<pre class="brush: js">document.querySelector('html').addEventListener('click',function(e) {
console.log(e.composed);
console.log(e.composedPath());
});</pre>

<p>当你先后点击 <code>&lt;open-shadow&gt;</code> 和 <code>&lt;closed-shadow&gt;</code> 这两个元素, 你将会注意到两件事情. 第一, <code>composed</code> 这个属性返回值为 <code>true</code> 因为 <code>click</code> 事件总能够在影子边界中传播。 第二,你将注意到两个元素中<code>composedPath</code> 的值的不同。 <code>&lt;open-shadow&gt;</code> 元素的组成路径是这个:</p>
<p>当你先后点击 <code>&lt;open-shadow&gt;</code> 和 <code>&lt;closed-shadow&gt;</code> 这两个元素你将会注意到两件事情第一, <code>composed</code> 这个属性返回值为 <code>true</code> 因为 <code>click</code> 事件总能够在影子边界中传播。 第二,你将注意到两个元素中<code>composedPath</code> 的值的不同。 <code>&lt;open-shadow&gt;</code> 元素的组成路径是这个</p>

<pre class="brush: js">Array [ p, ShadowRoot, open-shadow, body, html, HTMLDocument https://mdn.github.io/web-components-examples/composed-composed-path/, Window ]</pre>

<p>尽管 <code>&lt;closed-shadow&gt;</code> 元素的组成路径是像下面这样:</p>
<p>尽管 <code>&lt;closed-shadow&gt;</code> 元素的组成路径是像下面这样</p>

<pre class="brush: js">Array [ closed-shadow, body, html, HTMLDocument https://mdn.github.io/web-components-examples/composed-composed-path/, Window ]</pre>

Expand Down
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/event/currenttarget/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -34,10 +34,10 @@ <h2 id="Example" name="Example">例子</h2>
var ps = document.getElementsByTagName('p');

for(var i = 0; i &lt; ps.length; i++){
// console: 打印被点击的p元素
// console: 打印被点击的 p 元素
ps[i].addEventListener('click', hide, false);
}
// console: 打印body元素
// console: 打印 body 元素
document.body.addEventListener('click', hide, false);
</pre>

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/event/defaultprevented/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ <h2 id="概述">概述</h2>

<p>返回一个布尔值,表明当前事件是否调用了 {{ domxref("event.preventDefault()") }}方法。</p>

<div class="note"><strong>注意:</strong>你应该使用该属性来代替以前的非标准的已经被废弃的<code>getPreventDefault()</code>方法 (查看{{ bug("691151") }}).</div>
<div class="note"><strong>注意</strong>你应该使用该属性来代替以前的非标准的已经被废弃的<code>getPreventDefault()</code>方法 (查看{{ bug("691151") }}).</div>

<h2 id="语法">语法</h2>

Expand Down
10 changes: 5 additions & 5 deletions files/zh-cn/web/api/event/event/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
---
<p>{{APIRef("DOM")}}</p>

<p><code><strong>Event()</strong></code> 构造函数, 创建一个新的事件对象 {{domxref("Event")}}。</p>
<p><code><strong>Event()</strong></code> 构造函数创建一个新的事件对象 {{domxref("Event")}}。</p>

<h2 id="语法">语法</h2>

Expand All @@ -25,24 +25,24 @@ <h3 id="参数">参数</h3>
</dl>

<dl>
<dd><code>EventInit</code> 类型的字典,接受以下字段:
<dd><code>EventInit</code> 类型的字典,接受以下字段

<ul>
<li><code>"bubbles"</code>,可选,{{jsxref("Boolean")}}类型,默认值为 <code style="font-style: normal;">false</code>,表示该事件是否冒泡。</li>
<li><code>"cancelable"</code>,可选,{{jsxref("Boolean")}}类型,默认值为 <code style="font-style: normal;">false</code>, 表示该事件能否被取消。</li>
<li><code>"composed"</code>,可选,{{jsxref("Boolean")}}类型,默认值为 <code style="font-style: normal;">false</code>指示事件是否会在影子DOM根节点之外触发侦听器</li>
<li><code>"composed"</code>,可选,{{jsxref("Boolean")}}类型,默认值为 <code style="font-style: normal;">false</code>指示事件是否会在影子 DOM 根节点之外触发侦听器</li>
</ul>
</dd>
</dl>

<h2 id="示例">示例</h2>

<pre class="brush: js">// 创建一个支持冒泡且不能被取消的look事件
<pre class="brush: js">// 创建一个支持冒泡且不能被取消的 look 事件

var ev = new Event("look", {"bubbles":true, "cancelable":false});
document.dispatchEvent(ev);

<code>// 事件可以在任何元素触发,不仅仅是document
<code>// 事件可以在任何元素触发,不仅仅是 document
myDiv.dispatchEvent(ev);</code>
</pre>

Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/event/eventphase/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -37,17 +37,17 @@ <h3 id="下面这些值表示了事件流当前执行的阶段。">下面这些
<tr>
<td><code>Event.CAPTURING_PHASE</code></td>
<td>1</td>
<td>事件正在被目标元素的祖先对象处理. 这个处理过程从{{domxref("Window")}}开始,然后{{domxref("Document")}}, 然后是{{domxref("HTMLHtmlElement")}}, 一直这样,直到目标元素的父元素。 通过{{domxref("EventTarget.addEventListener()")}} 注册为捕获模式的{{domxref("EventListener", "Event listeners", "", 1)}} 被调用。</td>
<td>事件正在被目标元素的祖先对象处理这个处理过程从{{domxref("Window")}}开始,然后{{domxref("Document")}}, 然后是{{domxref("HTMLHtmlElement")}}, 一直这样,直到目标元素的父元素。 通过{{domxref("EventTarget.addEventListener()")}} 注册为捕获模式的{{domxref("EventListener", "Event listeners", "", 1)}} 被调用。</td>
</tr>
<tr>
<td><code>Event.AT_TARGET</code></td>
<td>2</td>
<td>事件对象已经抵达{{domxref("EventTarget", "the event's target", "", 1)}}. 为这个阶段注册的事件监听被调用。 如果 {{domxref("Event.bubbles")}} 的值为false, 对事件对象的处理在这个阶段后就会结束.</td>
<td>事件对象已经抵达{{domxref("EventTarget", "the event's target", "", 1)}}. 为这个阶段注册的事件监听被调用。 如果 {{domxref("Event.bubbles")}} 的值为 false,对事件对象的处理在这个阶段后就会结束</td>
</tr>
<tr>
<td><code>Event.BUBBLING_PHASE</code></td>
<td>3</td>
<td>事件对象逆向向上传播回目标元素的祖先元素, 从父亲元素开始,并且最终到达包含元素 {{domxref("Window")}}. 这就是冒泡,并且只有{{domxref("Event.bubbles")}} 值为true的时候才会发生。 为这个阶段注册的{{domxref("EventListener", "Event listeners", "", 1)}} 在这个过程中被触发.</td>
<td>事件对象逆向向上传播回目标元素的祖先元素从父亲元素开始,并且最终到达包含元素 {{domxref("Window")}}. 这就是冒泡,并且只有{{domxref("Event.bubbles")}} 值为 true 的时候才会发生。 为这个阶段注册的{{domxref("EventListener", "Event listeners", "", 1)}} 在这个过程中被触发</td>
</tr>
</tbody>
</table>
Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/event/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@

<p>有许多不同类型的事件,其中一些使用基于 <code>Event</code> 主接口的二次接口。<code>Event</code> 本身包含适用于所有事件的属性和方法。</p>

<p>很多DOM元素可以被设计接收(或者监听) 这些事件, 并且执行代码去响应(或者处理)它们。通过<code><a href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener" title="The EventTarget method addEventListener() sets up a function that will be called whenever the specified event is delivered to the target.">EventTarget.addEventListener()</a></code>方法可以将事件处理函数绑定到不同的<a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element">HTML elements</a>上 (比如<code>&lt;button&gt;</code>, <code>&lt;div&gt;</code>, <code>&lt;span&gt;</code>等等) 。这种绑定事件处理函数的方式基本替换了老版本中使用HTML <a href="https://developer.mozilla.org/en-US/docs/HTML/Global_attributes">event handler attributes</a>来绑定事件处理函数的方式。除此之外,通过正确使用<a href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener" title="The EventTarget.removeEventListener() method removes from the EventTarget an event listener previously registered with EventTarget.addEventListener(). The event listener to be removed is identified using a combination of the event type, the event listener function itself, and various optional options that may affect the matching process; see Matching event listeners for removal"><code>removeEventListener()</code></a>方法,这些事件处理函数也能被移除。</p>
<p>很多 DOM 元素可以被设计接收 (或者监听) 这些事件,并且执行代码去响应(或者处理)它们。通过<code><a href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener" title="The EventTarget method addEventListener() sets up a function that will be called whenever the specified event is delivered to the target.">EventTarget.addEventListener()</a></code>方法可以将事件处理函数绑定到不同的<a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element">HTML elements</a>上 (比如<code>&lt;button&gt;</code>, <code>&lt;div&gt;</code>, <code>&lt;span&gt;</code>等等) 。这种绑定事件处理函数的方式基本替换了老版本中使用 HTML <a href="https://developer.mozilla.org/en-US/docs/HTML/Global_attributes">event handler attributes</a>来绑定事件处理函数的方式。除此之外,通过正确使用<a href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener" title="The EventTarget.removeEventListener() method removes from the EventTarget an event listener previously registered with EventTarget.addEventListener(). The event listener to be removed is identified using a combination of the event type, the event listener function itself, and various optional options that may affect the matching process; see Matching event listeners for removal"><code>removeEventListener()</code></a>方法,这些事件处理函数也能被移除。</p>

<div class="blockIndicator note">
<p><strong>Note:</strong> 一个元素可以绑定多个事件处理函数,甚至是同一种类型的事件。尤其是这种分离的,并且相互独立的代码模块对同一个元素绑定事件处理函数,每一个模块代码都有着独立的目的。(比如,一个网页同时有着广告模块和统计模块同时监听视频播放元素)</p>
Expand All @@ -28,7 +28,7 @@

<h2 id="基于_Event_的接口">基于 <code>Event</code> 的接口</h2>

<p>下面是主要基于<code>Event</code>接口的接口列表,每一个接口都设置了指向各自的MDN API说明的文档链接</p>
<p>下面是主要基于<code>Event</code>接口的接口列表,每一个接口都设置了指向各自的 MDN API 说明的文档链接</p>

<p>需要注意的是,所有的事件接口名称都是以“Event”结尾的。</p>

Expand Down Expand Up @@ -119,7 +119,7 @@ <h2 id="属性">属性</h2>
<dt>{{domxref("Event.explicitOriginalTarget")}} {{non-standard_inline}} {{readonlyinline}}</dt>
<dd>事件的明确(explicit)原始目标(Mozilla 专有属性)。</dd>
<dt>{{domxref("Event.originalTarget")}} {{non-standard_inline}} {{readonlyinline}}</dt>
<dd>重设目标前的事件原始目标 (Mozilla 专有属性)。</dd>
<dd>重设目标前的事件原始目标(Mozilla 专有属性)。</dd>
<dt>{{domxref("Event.returnValue")}}</dt>
<dd>旧版 Internet Explorer 引入的一个非标准历史属性,为保证依赖此属性的网页正常运作,此属性最终被收入规范。可用 {{domxref("Event.preventDefault()")}} 与 {{domxref("Event.defaultPrevented")}} 代替,但由于已进入规范,也可以使用此属性。</dd>
<dt>{{domxref("Event.srcElement")}} {{non-standard_inline}}</dt>
Expand Down
18 changes: 9 additions & 9 deletions files/zh-cn/web/api/event/initevent/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,14 +5,14 @@
---
<div>{{ ApiRef("DOM") }}{{deprecated_header}}</div>

<p><strong><code>Event.initEvent()</code></strong> 方法可以用来初始化由{{domxref("Document.createEvent()") }} 创建的 {{ domxref("event") }} 实例.</p>
<p><strong><code>Event.initEvent()</code></strong> 方法可以用来初始化由{{domxref("Document.createEvent()") }} 创建的 {{ domxref("event") }} 实例</p>

<p>用这种方式初始化事件必须是由 {{ domxref("Document.createEvent()") }} 方法创建的实例. 本方法必须在事件被触发之前调用(用{{ domxref("EventTarget.dispatchEvent()") }}调用).事件 一旦被调用, 便不再做其他任何事.</p>
<p>用这种方式初始化事件必须是由 {{ domxref("Document.createEvent()") }} 方法创建的实例本方法必须在事件被触发之前调用(用{{ domxref("EventTarget.dispatchEvent()") }}调用).事件 一旦被调用便不再做其他任何事</p>

<div class="note">
<p><strong>不建议再使用此方法(方法已经过时deprecated</strong></p>
<p><strong>不建议再使用此方法(方法已经过时 deprecated</strong></p>

<p>可以使用特定的event构造器函数, 比如 {{domxref("Event.Event", "Event()")}}. 该页有关于这些的更多信息 <a href="/en-US/docs/Web/Guide/Events/Creating_and_triggering_events">Creating and triggering events</a> .</p>
<p>可以使用特定的 event 构造器函数,比如 {{domxref("Event.Event", "Event()")}}. 该页有关于这些的更多信息 <a href="/en-US/docs/Web/Guide/Events/Creating_and_triggering_events">Creating and triggering events</a> .</p>
</div>

<h2 id="Syntax" name="Syntax">语法</h2>
Expand All @@ -21,22 +21,22 @@ <h2 id="Syntax" name="Syntax">语法</h2>

<dl>
<dt><em><code>type</code></em></dt>
<dd>一个 {{domxref("DOMString")}} 类型的字段,定义了事件的类型.</dd>
<dd>一个 {{domxref("DOMString")}} 类型的字段,定义了事件的类型</dd>
<dt><em><code>bubbles</code></em></dt>
<dd>一个 {{jsxref("Boolean")}} 值,决定是否事件是否应该向上冒泡. 一旦设置了这个值,只读属性{{ domxref("Event.bubbles") }}也会获取相应的值.</dd>
<dd>一个 {{jsxref("Boolean")}} 值,决定是否事件是否应该向上冒泡一旦设置了这个值,只读属性{{ domxref("Event.bubbles") }}也会获取相应的值</dd>
<dt><em><code>cancelable</code></em></dt>
<dd>一个 {{jsxref("Boolean")}} 值,决定该事件的默认动作是否可以被取消. 一旦设置了这个值, 只读属性 {{ domxref("Event.cancelable") }} 也会获取相应的值.</dd>
<dd>一个 {{jsxref("Boolean")}} 值,决定该事件的默认动作是否可以被取消一旦设置了这个值只读属性 {{ domxref("Event.cancelable") }} 也会获取相应的值</dd>
</dl>

<h2 id="Example" name="Example">范例</h2>

<pre><code>// 创建事件.
<pre><code>// 创建事件
var event = document.createEvent('Event');
</code>
// 初始化一个点击事件,可以冒泡,无法被取消<code>
event.initEvent('click', true, false);

// 设置事件监听.
// 设置事件监听
elem.addEventListener('click', function (e) {
// e.target 就是监听事件目标元素
}, false);
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/event/istrusted/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ <h2 id="语法">语法</h2>

<h3 id=""></h3>

<p>{{domxref("Boolean")}} (布尔值)</p>
<p>{{domxref("Boolean")}}(布尔值)</p>

<h2 id="示例">示例</h2>

Expand Down
Loading

0 comments on commit 28ccb8a

Please sign in to comment.