Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

AutoCorrect files/zh-cn/web/api/n*/ #5912

Merged
merged 6 commits into from
May 29, 2022
Merged

AutoCorrect files/zh-cn/web/api/n*/ #5912

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
960baf8
AutoCorrect files/zh-cn/web/api/n*/
huacnlee May 28, 2022
d20ba4f
Update index.html
huacnlee May 29, 2022
ef5b090
Update index.html
huacnlee May 29, 2022
c51cf24
Update index.html
huacnlee May 29, 2022
9f3af52
Update index.html
huacnlee May 29, 2022
95681fc
Apply suggestions from code review
yin1999 May 29, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions files/zh-cn/web/api/namednodemap/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,10 @@

<p><code><strong>NamedNodeMap</strong></code> 接口表示属性节点 {{domxref("Attr")}} 对象的集合。尽管在 <code>NamedNodeMap</code> 里面的对象可以像数组一样通过索引来访问，但是它和 {{ domxref("NodeList") }} 不一样，对象的顺序没有指定。</p>

<p><code>NamedNodeMap</code> 对象是即时的(<em>live</em>)，因此，如果它内部包含的对象发生改变的话，该对象会自动更新到最新的状态。</p>
<p><code>NamedNodeMap</code> 对象是即时的 (<em>live</em>)，因此，如果它内部包含的对象发生改变的话，该对象会自动更新到最新的状态。</p>

<div class="note">
<p>尽管被称为 <code>NamedNodeMap</code>，但这个接口不是用来处理节点对象({{domxref("Node")}})，而是用来处理属性节点对象({{domxref("Attr")}})，属性节点原来是一种特殊的节点({{domxref("Node")}})，仍然在某些实现环境（浏览器）中有效。</p>
<p>尽管被称为 <code>NamedNodeMap</code>，但这个接口不是用来处理节点对象 ({{domxref("Node")}})，而是用来处理属性节点对象 ({{domxref("Attr")}})，属性节点原来是一种特殊的节点 ({{domxref("Node")}})，仍然在某些实现环境（浏览器）中有效。</p>
</div>

<h2 id="属性">属性</h2>
Expand All @@ -19,7 +19,7 @@ <h2 id="属性">属性</h2>

<dl>
<dt>{{ domxref("NamedNodeMap.length") }} {{ReadOnlyInline}}</dt>
<dd>返回映射(map)中对象的数量。</dd>
<dd>返回映射 (map) 中对象的数量。</dd>
</dl>

<h2 id="方法">方法</h2>
Expand All @@ -36,11 +36,11 @@ <h2 id="方法">方法</h2>
<dt>{{domxref("NamedNodeMap.item()")}}</dt>
<dd>返回指定索引处的属性节点（{{ domxref("Attr") }}），或者，当索引超出或等于属性节点的数量时，返回 <code>null</code>。</dd>
<dt>{{domxref("NamedNodeMap.getNamedItemNS()")}}</dt>
<dd>根据给定的命名空间参数和name参数返回一个{{ domxref("Attr") }}对象。</dd>
<dd>根据给定的命名空间参数和 name 参数返回一个{{ domxref("Attr") }}对象。</dd>
yin1999 marked this conversation as resolved.
Show resolved Hide resolved
<dt>{{domxref("NamedNodeMap.setNamedItemNS()")}}</dt>
<dd>替换、添加给定命名空间参数和name参数的{{ domxref("Attr") }} 对象 。</dd>
<dd>替换、添加给定命名空间参数和 name 参数的{{ domxref("Attr") }} 对象 。</dd>
yin1999 marked this conversation as resolved.
Show resolved Hide resolved
<dt>{{domxref("NamedNodeMap.removeNamedItemNS()")}}</dt>
<dd>删除给定命名空间参数和name参数的{{ domxref("Attr") }} 对象 。</dd>
<dd>删除给定命名空间参数和 name 参数的{{ domxref("Attr") }} 对象 。</dd>
yin1999 marked this conversation as resolved.
Show resolved Hide resolved
</dl>

<h2 id="规范">规范</h2>
Expand Down
18 changes: 9 additions & 9 deletions files/zh-cn/web/api/navigation_timing_api/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,33 +7,33 @@
---
<p>{{DefaultAPISidebar("Navigation Timing")}}</p>

<p><strong>Navigation Timing API</strong> 提供了可用于衡量一个网站性能的数据。与用于相同目的的其他基于JavaScript的机制不同，该API可以提供可以更有用和更准确的端到端延迟数据。</p>
<p><strong>Navigation Timing API</strong> 提供了可用于衡量一个网站性能的数据。与用于相同目的的其他基于 JavaScript 的机制不同，该 API 可以提供可以更有用和更准确的端到端延迟数据。</p>

<p> </p>

yin1999 marked this conversation as resolved.
Show resolved Hide resolved
<h2 id="Concepts_and_usage">Concepts and usage</h2>

<p>你可以使用Navigation Timing API在客户端收集性能数据，并用{{domxref("XMLHttpRequest")}} 或其它技术传送到服务端。同时，该API使你可以衡量之前难以获取的数据，如卸载前一个页面的时间，在域名解析上的时间，在执行{{event("load")}}事件处理器上花费的总时间等。</p>
<p>你可以使用 Navigation Timing API 在客户端收集性能数据，并用 {{domxref("XMLHttpRequest")}} 或其它技术传送到服务端。同时，该 API 使你可以衡量之前难以获取的数据，如卸载前一个页面的时间，在域名解析上的时间，在执行 {{event("load")}} 事件处理器上花费的总时间等。</p>

<p> </p>

yin1999 marked this conversation as resolved.
Show resolved Hide resolved
<h2 id="Interfaces">Interfaces</h2>

<p>{{domxref("Performance")}}</p>

<p>返回一个Performance对象。该对象由High Resolution Time API定义，Navigation Timing API 在此基础上增加了两个属性：{{domxref("Performance.timing", "timing")}} 和 {{domxref("Performance.navigation", "navigation")}}</p>
<p>返回一个 Performance 对象。该对象由 High Resolution Time API 定义，Navigation Timing API 在此基础上增加了两个属性：{{domxref("Performance.timing", "timing")}} 和 {{domxref("Performance.navigation", "navigation")}}</p>

<p>{{domxref("PerformanceNavigationTiming")}}</p>

<p>提供了方法和属性来存取关于游览器文档navigation事件的相关数据。如文档实际加载/卸载的时间。</p>
<p>提供了方法和属性来存取关于游览器文档 navigation 事件的相关数据。如文档实际加载/卸载的时间。</p>

<p>{{deprecated_inline}} {{domxref("PerformanceTiming")}}</p>

<p>曾被用来获取{{domxref("Performance.timing", "timing")}}的值，用来衡量页面性能。</p>
<p>曾被用来获取 {{domxref("Performance.timing", "timing")}} 的值，用来衡量页面性能。</p>

<p>{{deprecated_inline}}  {{domxref("PerformanceNavigation")}}</p>

<p>曾被用来获取{{domxref("Performance.navigation", "navigation")}}的值，用来描述加载相关的操作。</p>
<p>曾被用来获取 {{domxref("Performance.navigation", "navigation")}} 的值，用来描述加载相关的操作。</p>

<p> </p>

Expand All @@ -48,7 +48,7 @@ <h2 id="Interfaces">Interfaces</h2>
}
</pre>

<p>还有很多以毫秒为单位呈现的测量事件，你可以通过  {{domxref("PerformanceTiming")}} 接口得到它们。按照事件发生的先后顺序，这些事件的列表如下：</p>
<p>还有很多以毫秒为单位呈现的测量事件，你可以通过 {{domxref("PerformanceTiming")}} 接口得到它们。按照事件发生的先后顺序，这些事件的列表如下：</p>

<ul>
<li>navigationStart</li>
Expand All @@ -74,7 +74,7 @@ <h2 id="Interfaces">Interfaces</h2>
<li>loadEventEnd</li>
</ul>

<p><code>window.performance.navigation 对象存储了两个属性，它们表示触发页面加载的原因。这些原因可能是页面重定向、前进后退按钮或者普通的 </code>URL<code> 加载。</code></p>
<p><code>window.performance.navigation</code> 对象存储了两个属性，它们表示触发页面加载的原因。这些原因可能是页面重定向、前进后退按钮或者普通的 <code>URL</code> 加载。</p>

<p>window.performance.navigation.type：</p>

Expand Down Expand Up @@ -120,7 +120,7 @@ <h2 id="Interfaces">Interfaces</h2>

<p><code>window.performance.navigation.redirectCount 表示到达最终页面前，重定向的次数（如果有的话）。</code></p>

<p>Navigation Timing API 可以用于收集客户端性能数据，然后通过 XHR 发送给服务端。还可以计算那些其他方法难以计算的数据，如卸载( unload )上一个页面的时间、域名查找时间、window.onload 的总时间等等。</p>
<p>Navigation Timing API 可以用于收集客户端性能数据，然后通过 XHR 发送给服务端。还可以计算那些其他方法难以计算的数据，如卸载 (unload) 上一个页面的时间、域名查找时间、window.onload 的总时间等等。</p>

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

Expand Down
18 changes: 9 additions & 9 deletions files/zh-cn/web/api/navigation_timing_api/using_navigation_timing/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

<h2 id="收集计时信息">收集计时信息</h2>

<p>使用该API就像使用{{domxref("window.performance")}}获取{{domxref("Performance")}}对象并在返回的对象中查找所需内容一样简单。比如，为了测量页面的感知到的加载时间：</p>
<p>使用该 API 就像使用 {{domxref("window.performance")}} 获取 {{domxref("Performance")}} 对象并在返回的对象中查找所需内容一样简单。比如，为了测量页面的感知到的加载时间：</p>

<pre class="brush: js">window.addEventListener("load", function() {
let now = new Date().getTime();
Expand All @@ -24,7 +24,7 @@ <h2 id="收集计时信息">收集计时信息</h2>
loadingTime + " ms";
}, false);</pre>

<p>在发生{{event("load")}}事件时执行的该代码从当前时间中减去浏览器导航开始时记录的时间({{domxref("PerformanceTiming.navigationStart", "performance.timing.navigationStart")}})，并通过将该信息插入到元素中，输出到屏幕。</p>
<p>在发生 {{event("load")}} 事件时执行的该代码从当前时间中减去浏览器导航开始时记录的时间 ({{domxref("PerformanceTiming.navigationStart", "performance.timing.navigationStart")}})，并通过将该信息插入到元素中，输出到屏幕。</p>

<div class="hidden">
<h4 id="HTML">HTML</h4>
Expand All @@ -40,25 +40,25 @@ <h4 id="CSS">CSS</h4>
}</pre>
</div>

<p>结合适当的HTML和CSS，结果就是：</p>
<p>结合适当的 HTML 和 CSS，结果就是：</p>

<p>{{EmbedLiveSample("收集计时信息", 500, 80)}}</p>

<p>列出的值适用于上面展示了示例的{{HTMLElement("iframe")}}。</p>
<p>列出的值适用于上面展示了示例的 {{HTMLElement("iframe")}}。</p>

<p>你可以在{{domxref("PerformanceTiming")}}中查找可用的计时值的列表，请参见{{domxref("PerformanceTiming")}}接口的“<a href="/zh-CN/docs/Web/API/PerformanceTiming">属性</a>”部分。</p>
<p>你可以在 {{domxref("PerformanceTiming")}} 中查找可用的计时值的列表，请参见 {{domxref("PerformanceTiming")}} 接口的“<a href="/zh-CN/docs/Web/API/PerformanceTiming">属性</a>”部分。</p>

<h2 id="确定导航类型">确定导航类型</h2>

<p>为了将从 {{domxref("PerformanceTiming")}}获取到的计时信息放入正确的观点，你需要更多地了解发生了哪种加载操作。特别是你需要知道：</p>
<p>为了将从 {{domxref("PerformanceTiming")}} 获取到的计时信息放入正确的观点，你需要更多地了解发生了哪种加载操作。特别是你需要知道：</p>

<ul>
<li>这是加载还是重新加载？</li>
<li>这是历史的导航还是前进或后退？</li>
<li>完成导航需要多少个（如果有）重定向？</li>
</ul>

<p>此信息由{{domxref("Performance.navigation")}}属性提供，该属性返回包含所需信息的{{domxref("PerformanceNavigation")}}对象。</p>
<p>此信息由 {{domxref("Performance.navigation")}} 属性提供，该属性返回包含所需信息的 {{domxref("PerformanceNavigation")}} 对象。</p>

<p>让我们将此信息添加到上面的示例中。 新代码如下所示：</p>

Expand Down Expand Up @@ -89,7 +89,7 @@ <h2 id="确定导航类型">确定导航类型</h2>
document.querySelector(".output").innerHTML = output;
}, false);</pre>

<p>这通过查看<code>performance.navigation</code>对象的内容来修改了前面的示例。{{domxref("PerformanceNavigation.type", "performance.navigation.type")}}指示发生了哪种加载操作：导航，重新加载或浏览器历史记录的切换。我们还从{{domxref("PerformanceNavigation.redirectCount", "performance.navigation.redirectCount")}}获取导航期间发生的重定向次数。就像以前的页面加载时间一样，此信息通过插入到具有<code>"output"</code>类的元素中输出到屏幕上。</p>
<p>这通过查看 <code>performance.navigation</code> 对象的内容来修改了前面的示例。{{domxref("PerformanceNavigation.type", "performance.navigation.type")}} 指示发生了哪种加载操作：导航，重新加载或浏览器历史记录的切换。我们还从 {{domxref("PerformanceNavigation.redirectCount", "performance.navigation.redirectCount")}} 获取导航期间发生的重定向次数。就像以前的页面加载时间一样，此信息通过插入到具有 <code>"output"</code> 类的元素中输出到屏幕上。</p>

<div class="hidden">
<h4 id="HTML_2">HTML</h4>
Expand All @@ -109,7 +109,7 @@ <h4 id="CSS_2">CSS</h4>

<p>{{EmbedLiveSample("确定导航类型", 500, 120)}}</p>

<p>列出的值适用于展示示例的 {{HTMLElement("iframe")}} 。</p>
<p>列出的值适用于展示示例的 {{HTMLElement("iframe")}}。</p>

<h2 id="也可以看看">也可以看看</h2>

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/networkinformation/downlink/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<p>{{SeeCompatTable}}{{APIRef("Network Information API")}}</p>

<p><strong><code>downlink</code></strong> 是 {{domxref("NetworkInformation")}} 接口的一个只读属性，返回以Mb/s为单位的有效带宽，并保留该值为25kb/s的最接近的整数倍。该值基于最近监测的保持活跃连接的应用层吞吐量，排除了到私有地址空间的连接。当缺少最近的带宽测量数据时，该属性由底层连接技术属性决定。</p>
<p><strong><code>downlink</code></strong> 是 {{domxref("NetworkInformation")}} 接口的一个只读属性，返回以 Mb/s 为单位的有效带宽，并保留该值为 25kb/s 的最接近的整数倍。该值基于最近监测的保持活跃连接的应用层吞吐量，排除了到私有地址空间的连接。当缺少最近的带宽测量数据时，该属性由底层连接技术属性决定。</p>

<h2 id="Syntax">Syntax</h2>

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/networkinformation/rtt/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<p>{{apiref("Network Information API")}}{{SeeCompatTable}}</p>

<p><strong>NetworkInformation.rtt </strong>是一个只读属性，返回了当前连接下评估的往返时延（RTT, round-trip time ），并保留该值为25千分秒的最接近的整数倍。该值基于最近使用中被监测的最近保持活跃连接的应用层上的RTT测量值。它排除了到私有地址空间的连接。如果没有最近的测量数据，该值就基于底层连接技术的属性。</p>
<p><strong>NetworkInformation.rtt </strong>是一个只读属性，返回了当前连接下评估的往返时延（RTT, round-trip time ），并保留该值为 25 千分秒的最接近的整数倍。该值基于最近使用中被监测的最近保持活跃连接的应用层上的 RTT 测量值。它排除了到私有地址空间的连接。如果没有最近的测量数据，该值就基于底层连接技术的属性。</p>

<p>{{AvailableInWorkers}}</p>

Expand Down
18 changes: 9 additions & 9 deletions files/zh-cn/web/api/nodeiterator/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

<p><strong><code>NodeIterator</code></strong> 接口表示一个遍历 DOM 子树中节点列表的成员的迭代器。节点将按照文档顺序返回。</p>

<p>NodeIterator可以使用{{domxref("Document.createNodeIterator()")}} 方法创建，如下所示：</p>
<p>NodeIterator 可以使用 {{domxref("Document.createNodeIterator()")}} 方法创建，如下所示：</p>

<pre class="brush: js">var nodeIterator = document.createNodeIterator(<em>root</em>, <em>whatToShow</em>, <em>filter</em>);</pre>

Expand All @@ -20,9 +20,9 @@ <h2 id="Properties" name="Properties">属性</h2>

<dl>
<dt>{{domxref("NodeIterator.root")}} {{readonlyInline}}</dt>
<dd>返回一个{{domxref("Node")}} ，它代表创建 NodeIterator 时指定的根节点。</dd>
<dd>返回一个 {{domxref("Node")}}，它代表创建 NodeIterator 时指定的根节点。</dd>
<dt>{{domxref("NodeIterator.whatToShow")}} {{readonlyInline}}</dt>
<dd>返回一个无符号长整型，它是一个由描述必须呈现的{{domxref("Node")}}类型的常量构成的位掩码。不匹配的节点被跳过，但是如果相关，他们的子节点可能被包括在内。可能的值是：
<dd>返回一个无符号长整型，它是一个由描述必须呈现的 {{domxref("Node")}} 类型的常量构成的位掩码。不匹配的节点被跳过，但是如果相关，他们的子节点可能被包括在内。可能的值是：
<table class="standard-table">
<tbody>
<tr>
Expand All @@ -38,7 +38,7 @@ <h2 id="Properties" name="Properties">属性</h2>
<tr>
<td><code>NodeFilter.SHOW_ATTRIBUTE</code> {{obsolete_inline}}</td>
<td><code>2</code></td>
<td>显示属性 {{ domxref("Attr") }} 节点. 只有当用一个 {{ domxref("Attr") }} 节点作为根节点来创建 {{ domxref("NodeIterator") }} 时才有意义; 在这种情况下, 这意味着属性节点会出现在迭代或遍历的首位. 因为属性永远不会是其它节点的子节点, 当遍历整个文档树时它们不会出现.</td>
<td>显示属性 {{ domxref("Attr") }} 节点。只有当用一个 {{ domxref("Attr") }} 节点作为根节点来创建 {{ domxref("NodeIterator") }} 时才有意义; 在这种情况下，这意味着属性节点会出现在迭代或遍历的首位。因为属性永远不会是其它节点的子节点，当遍历整个文档树时它们不会出现。</td>
</tr>
<tr>
<td><code>NodeFilter.SHOW_CDATA_SECTION</code> {{obsolete_inline}}</td>
Expand Down Expand Up @@ -75,7 +75,7 @@ <h2 id="Properties" name="Properties">属性</h2>
<tr>
<td><code>NodeFilter.SHOW_ENTITY</code> {{obsolete_inline}}</td>
<td><code>32</code></td>
<td>显示 {{ domxref("Entity") }} 节点. 只有当用一个 {{ domxref("Entity") }} 节点作为它的根节点来创建一个 {{ domxref("NodeIterator") }} 时才有意义; 在这种情况下,  {{ domxref("Entity") }} 节点会出现在迭代或遍历的首位. 因为 {{ domxref("Entity") }}  永远不会是其它节点的子节点, 当遍历整个文档树时它们不会出现.</td>
<td>显示 {{ domxref("Entity") }} 节点。只有当用一个 {{ domxref("Entity") }} 节点作为它的根节点来创建一个 {{ domxref("NodeIterator") }} 时才有意义; 在这种情况下，  {{ domxref("Entity") }} 节点会出现在迭代或遍历的首位。因为 {{ domxref("Entity") }} 永远不会是其它节点的子节点，当遍历整个文档树时它们不会出现。</td>
</tr>
<tr>
<td><code>NodeFilter.SHOW_ENTITY_REFERENCE</code> {{obsolete_inline}}</td>
Expand All @@ -85,7 +85,7 @@ <h2 id="Properties" name="Properties">属性</h2>
<tr>
<td><code>NodeFilter.SHOW_NOTATION</code> {{obsolete_inline}}</td>
<td><code>2048</code></td>
<td>显示 {{ domxref("Notation") }} 节点. 只有当用一个 {{ domxref("Notation") }} 节点作为它的根节点时来创建一个 {{ domxref("NodeIterator") }} 才有意义; 在这种情况下,  {{ domxref("Notation") }} 节点会出现在迭代或遍历的首位. 因为 {{ domxref("Notation") }}  永远不会是其它节点的子节点, 当遍历整个文档树时它们不会出现.</td>
<td>显示 {{ domxref("Notation") }} 节点。只有当用一个 {{ domxref("Notation") }} 节点作为它的根节点时来创建一个 {{ domxref("NodeIterator") }} 才有意义; 在这种情况下，  {{ domxref("Notation") }} 节点会出现在迭代或遍历的首位。因为 {{ domxref("Notation") }}  永远不会是其它节点的子节点，当遍历整个文档树时它们不会出现。</td>
</tr>
<tr>
<td><code>NodeFilter.SHOW_PROCESSING_INSTRUCTION</code></td>
Expand Down Expand Up @@ -116,11 +116,11 @@ <h2 id="Methods" name="Methods">方法</h2>

<dl>
<dt>{{domxref("NodeIterator.detach()")}} {{obsolete_inline()}}</dt>
<dd>这个方法不是必需的. 它现在什么也不做. 之前用来告诉引擎，<code>NodeIterator</code> 已经不会再使用，现在已经不做任何事情.</dd>
<dd>这个方法不是必需的。它现在什么也不做. 之前用来告诉引擎，<code>NodeIterator</code> 已经不会再使用，现在已经不做任何事情。</dd>
<dt>{{domxref("NodeIterator.previousNode()")}}</dt>
<dd>返回前一个 {{domxref("Node")}} ，如果不存在则返回 <code>null</code>.</dd>
<dd>返回前一个 {{domxref("Node")}}，如果不存在则返回 <code>null</code>.</dd>
<dt>{{domxref("NodeIterator.nextNode()")}}</dt>
<dd>返回下一个 {{domxref("Node")}} , 如果不存在则返回<code>null</code> .</dd>
<dd>返回下一个 {{domxref("Node")}}, 如果不存在则返回<code>null</code> .</dd>
</dl>

<h2 id="Specification" name="Specification">特性</h2>
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/nodelist/entries/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ <h2 id="例子">例子</h2>
}
</pre>

<p>结果如下:</p>
<p>结果如下：</p>

<pre>Array [ 0, &lt;p&gt; ]
Array [ 1, #text "hey" ]
Expand Down
Loading