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.

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/conflicting #6097

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
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

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion files/zh-cn/conflicting/web/api/audionode/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
---
<p>{{APIRef("'Web Audio API'")}}</p>

<p><span class="seoSummary"><a href="/en-US/docs/Web/API/Web_Audio_API">Web Audio API</a> 的 <strong><code>AudioNodeOptions</code></strong> 字典指定了创建新 {{domxref("AudioNode")}} 对象时可使用的选项.</span></p>
<p><span class="seoSummary"><a href="/en-US/docs/Web/API/Web_Audio_API">Web Audio API</a> 的 <strong><code>AudioNodeOptions</code></strong> 字典指定了创建新 {{domxref("AudioNode")}} 对象时可使用的选项</span></p>

<p><code>AudioNodeOptions</code> 继承自不同类型的音频节点构造函数的选项对象. 例如 {{domxref("AnalyserNode.AnalyserNode")}} 或 {{domxref("GainNode.GainNode")}}.</p>

Expand Down
4 changes: 2 additions & 2 deletions files/zh-cn/conflicting/web/api/blob/size/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,6 @@

<h3 id="概述">概述</h3>

<p>返回文件的大小,单位为字节.</p>
<p>返回文件的大小单位为字节</p>

<div class="note">该属性已经废弃,请使用{{domxref("File.size")}}来代替.</div>
<div class="note">该属性已经废弃请使用{{domxref("File.size")}}来代替</div>
2 changes: 1 addition & 1 deletion files/zh-cn/conflicting/web/api/caches/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
---
<p>{{APIRef("Service Workers API")}}</p>

<p><strong><code>caches </code></strong>是一个 {{domxref("ServiceWorkerGlobalScope")}} 接口的只读属性,返回与当前service worker相关联的{{domxref("CacheStorage")}}对象。</p>
<p><strong><code>caches </code></strong>是一个 {{domxref("ServiceWorkerGlobalScope")}} 接口的只读属性,返回与当前 service worker 相关联的{{domxref("CacheStorage")}}对象。</p>

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
---
<div>{{APIRef()}} {{SeeCompatTable}}</div>

<p><code style="font-style: normal;"><strong>CanvasRenderingContext2D</strong></code><strong><code>.currentTransform</code></strong> 属性,表示当前变换的矩阵。可以通过Canvas2D API 返回或者赋值为{{domxref("SVGMatrix")}}对象。</p>
<p><code style="font-style: normal;"><strong>CanvasRenderingContext2D</strong></code><strong><code>.currentTransform</code></strong> 属性,表示当前变换的矩阵。可以通过 Canvas2D API 返回或者赋值为{{domxref("SVGMatrix")}}对象。</p>

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

Expand All @@ -22,7 +22,7 @@ <h2 id="示例">示例</h2>

<h3 id="使用currentTransform_的方式"><code><font face="Open Sans, sans-serif">使用</font>currentTransform</code> 的方式</h3>

<p>这是一段简单的代码片段,使用<span style="font-family: consolas,monaco,andale mono,monospace;">currentTransform属性设置变换矩阵。</span></p>
<p>这是一段简单的代码片段,使用<span style="font-family: consolas,monaco,andale mono,monospace;">currentTransform 属性设置变换矩阵。</span></p>

<h4 id="HTML">HTML</h4>

Expand All @@ -45,7 +45,7 @@ <h4 id="JavaScript">JavaScript</h4>
ctx.fillRect(0,0,100,100);
</pre>

<p>修改下面的代码并在线查看canvas的变化(确定使用支持这段代码特征的浏览器,可以查看兼容性列表):</p>
<p>修改下面的代码并在线查看 canvas 的变化(确定使用支持这段代码特征的浏览器,可以查看兼容性列表):</p>

<div class="hidden">
<h6 id="Playable_code">Playable code</h6>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,16 +20,16 @@
</tr>
<tr>
<td><code>NodeFilter.FILTER_REJECT</code></td>
<td>当一个节点应被拒绝时由 {{ domxref("NodeFilter.acceptNode()") }} 返回 。被拒绝访问节点的子节点无法通过{{ domxref("NodeIterator") }} 或 {{ domxref("TreeWalker") }} 对象访问。该值可认为是“越过该节点及其子节点” 。</td>
<td>当一个节点应被拒绝时由 {{ domxref("NodeFilter.acceptNode()") }} 返回。被拒绝访问节点的子节点无法通过{{ domxref("NodeIterator") }} 或 {{ domxref("TreeWalker") }} 对象访问。该值可认为是“越过该节点及其子节点” 。</td>
</tr>
<tr>
<td><code>NodeFilter.FILTER_SKIP</code></td>
<td>当一个节点应被 {{ domxref("NodeIterator") }} 或 {{ domxref("TreeWalker") }} 对象越过时由 {{ domxref("NodeFilter.acceptNode()") }} 返回 。其子节点依然可被访问到。该值可认为是“越过该节点但不包括其子节点”。</td>
<td>当一个节点应被 {{ domxref("NodeIterator") }} 或 {{ domxref("TreeWalker") }} 对象越过时由 {{ domxref("NodeFilter.acceptNode()") }} 返回。其子节点依然可被访问到。该值可认为是“越过该节点但不包括其子节点”。</td>
</tr>
</tbody>
</table>

<p>该函数如需要TreeWalker访问节点则需返回 <code>NodeFilter.FILTER_ACCEPT,<font face="Open Sans, arial, sans-serif">如果需要忽略节点及其子节点则需返回</font></code><code>NodeFilter.FILTER_REJECT,除此之外还可以返回</code> <code>NodeFilter.FILTER_SKIP。</code></p>
<p>该函数如需要 TreeWalker 访问节点则需返回 <code>NodeFilter.FILTER_ACCEPT,<font face="Open Sans, arial, sans-serif">如果需要忽略节点及其子节点则需返回</font></code><code>NodeFilter.FILTER_REJECT,除此之外还可以返回</code> <code>NodeFilter.FILTER_SKIP。</code></p>

<p>浏览器没有提供该方法的对象实现。如果用户需要,应实现一个包含<code>acceptNode()方法的对象,用于</code> {{domxref("TreeWalker")}} 或 {{domxref("NodeIterator")}} 对象使用。</p>

Expand All @@ -54,7 +54,7 @@ <h2 id="Example">Example</h2>
// 只需要文本节点
NodeFilter.SHOW_TEXT,

// 一个包含用于NodeFilter的accpetNode方法的对象
// 一个包含用于 NodeFilter 的 accpetNode 方法的对象
{ acceptNode: function(node) {
// 一段用于判明是否需要解释、拒绝或越过节点的逻辑
// 在本例中,仅需要接受不包含空白内容的节点
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ <h2 id="示例">示例</h2>
// 用作根节点的节点
document.getElementById('someId'),

// 只筛选文本节点(即节点类型3
// 只筛选文本节点(即节点类型 3
NodeFilter.SHOW_TEXT,

// 用作 NodeFilter 的对象,其中包含 acceptNode 方法
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ <h3 id="Value">Value</h3>

<h2 id="使用说明">使用说明</h2>

<p><code>fullscreenchange</code>事件不会直接说明文档当前是进入还是退出全屏模式,因此你的事件处理程序应查看{{domxref("Document.fullscreenElement")}}的值。 如果为null,则该事件表示已退出全屏模式; 否则,指定的元素将接管屏幕。</p>
<p><code>fullscreenchange</code>事件不会直接说明文档当前是进入还是退出全屏模式,因此你的事件处理程序应查看{{domxref("Document.fullscreenElement")}}的值。如果为 null,则该事件表示已退出全屏模式; 否则,指定的元素将接管屏幕。</p>

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ <h2 id="Syntax">Syntax</h2>
</pre>

<ul>
<li><code>function</code> 是一个用户定义的方法的名字(而非带()和任何参数的函数调用),或者匿名函数的申明。</li>
<li><code>function</code> 是一个用户定义的方法的名字(而非带 () 和任何参数的函数调用),或者匿名函数的申明。</li>
</ul>

<h2 id="例子">例子</h2>
Expand Down
4 changes: 2 additions & 2 deletions files/zh-cn/conflicting/web/api/file/name/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,6 @@

<h3 id="概述">概述</h3>

<p>返回文件的名称.由于安全原因,返回的值并不包含文件路径.</p>
<p>返回文件的名称由于安全原因返回的值并不包含文件路径</p>

<div class="note">该属性已经废弃.请使用{{domxref("File.name")}}来代替.</div>
<div class="note">该属性已经废弃请使用{{domxref("File.name")}}来代替</div>
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,11 @@
---
<p>{{non-standard_header}}</p>

<p>FileHandle API允许处理文件,包括创建文件和修改其内容(unlike the <a href="/en-US/docs/DOM/File" title="DOM/File">File API</a>)。由于通过该API操作的文件可以物理存储在设备上,因此编辑部分使用基于回合的锁定机制,以避免出现种族问题。</p>
<p>FileHandle API 允许处理文件,包括创建文件和修改其内容 (unlike the <a href="/en-US/docs/DOM/File" title="DOM/File">File API</a>)。由于通过该 API 操作的文件可以物理存储在设备上,因此编辑部分使用基于回合的锁定机制,以避免出现种族问题。</p>

<h2 id="API概述">API概述</h2>
<h2 id="API概述">API 概述</h2>

<p>该API基于以下接口:</p>
<p>该 API 基于以下接口:</p>

<ul>
<li>{{domxref("IDBDatabase.mozCreateFileHandle")}} (was called {{domxref("IDBDatabase.mozCreateFileHandle")}}.)</li>
Expand All @@ -19,13 +19,13 @@ <h2 id="API概述">API概述</h2>
<li>{{domxref("FileRequest")}}</li>
</ul>

<p>它还与File API,尤其是 {{domxref("File")}} 和{{domxref("Blob")}} 接口具有连接。</p>
<p>它还与 File API,尤其是 {{domxref("File")}} 和{{domxref("Blob")}} 接口具有连接。</p>

<h2 id="Basic_operations">Basic operations</h2>

<h3 id="创建文件句柄">创建文件句柄</h3>

<p>因为目的是允许通过IndexedDB存储文件,所以创建{{domxref("FileHandle")}}实例需要<a href="/en-US/docs/IndexedDB/IDBFactory#open" title="IndexedDB/IDBFactory#open">IndexedDB Database</a>。</p>
<p>因为目的是允许通过 IndexedDB 存储文件,所以创建{{domxref("FileHandle")}}实例需要<a href="/en-US/docs/IndexedDB/IDBFactory#open" title="IndexedDB/IDBFactory#open">IndexedDB Database</a>。</p>

<div style="overflow: hidden;">
<pre class="brush: js notranslate">var IDBReq = indexedDB.open("myFileStorageDataBase");
Expand All @@ -42,15 +42,15 @@ <h3 id="创建文件句柄">创建文件句柄</h3>
</pre>
</div>

<p>{{domxref("IDBDatabase.mozCreateFileHandle","mozCreateFileHandle()")}}接受两个参数:名称和可选类型。 这两个都是描述性的,数据库不使用。 但是,它们对于{{domxref("FileHandle")}}对象很重要,因为它可以生成{{domxref("File")}}对象,这些对象继承自己的{{domxref("File.name","name")}}和{{domxref("File.type","type")}}的值。 就是说,由于名称与任何实际文件名都不匹配,因此它可以是一个空字符串,甚至不必是唯一的。</p>
<p>{{domxref("IDBDatabase.mozCreateFileHandle","mozCreateFileHandle()")}}接受两个参数:名称和可选类型。这两个都是描述性的,数据库不使用。但是,它们对于{{domxref("FileHandle")}}对象很重要,因为它可以生成{{domxref("File")}}对象,这些对象继承自己的{{domxref("File.name","name")}}和{{domxref("File.type","type")}}的值。就是说,由于名称与任何实际文件名都不匹配,因此它可以是一个空字符串,甚至不必是唯一的。</p>

<div class="note">
<p><strong>Note:</strong> the above code only creates a "temporary file" that exists only while you hold the {{domxref("FileHandle")}} instance. If you want a file to survive a page refresh/app relaunch, you need to store the handle in a more permanent location, like the database itself. See <a href="#文件储存">文件储存</a> below to learn more about this.</p>
</div>

<h3 id="执行读写操作">执行读写操作</h3>

<p>要在已处理的文件中进行读取或写入,需要获取{{domxref("LockedFile")}}。 {{domxref("FileHandle.open()")}} 方法提供了这样的对象,该对象可以是<code>readonly</code>的也可以是<code>readwrite</code>的。 对<code>readonly</code>{{domxref("LockedFile")}} 对象执行写操作的任何尝试都将失败。</p>
<p>要在已处理的文件中进行读取或写入,需要获取{{domxref("LockedFile")}}。 {{domxref("FileHandle.open()")}} 方法提供了这样的对象,该对象可以是<code>readonly</code>的也可以是<code>readwrite</code>的。对<code>readonly</code>{{domxref("LockedFile")}} 对象执行写操作的任何尝试都将失败。</p>

<h4 id="Writing">Writing</h4>

Expand Down Expand Up @@ -79,11 +79,11 @@ <h4 id="Writing">Writing</h4>

<h4 id="Reading">Reading</h4>

<p>可以直接写入{{domxref("LockedFile")}} 对象的内容,而无需使用中间的{{domxref("File")}}对象和 {{domxref("FileReader")}}对象。 {{domxref("LockedFile")}}接口提供了{{domxref("LockedFile.readAsText","readAsText")}}方法和{{domxref("LockedFile.readAsArrayBuffer","readAsArrayBuffer")}}方法 。</p>
<p>可以直接写入{{domxref("LockedFile")}} 对象的内容,而无需使用中间的{{domxref("File")}}对象和 {{domxref("FileReader")}}对象。 {{domxref("LockedFile")}}接口提供了{{domxref("LockedFile.readAsText","readAsText")}}方法和{{domxref("LockedFile.readAsArrayBuffer","readAsArrayBuffer")}}方法。</p>

<p>这两种方法期望一个大小来指示必须从{{domxref("LockedFile.location")}}字节开始读取多少个字节。</p>

<p>要读取整个文件,需要知道其大小。 可以通过{{domxref("LockedFile.getMetadata()")}}方法来检索此信息(及其最后修改日期)。</p>
<p>要读取整个文件,需要知道其大小。可以通过{{domxref("LockedFile.getMetadata()")}}方法来检索此信息(及其最后修改日期)。</p>

<pre class="brush: js notranslate">// Get a LockedFile object from the handle
var myFile = myFileHandle.open('readwrite');
Expand Down Expand Up @@ -113,9 +113,9 @@ <h4 id="Reading">Reading</h4>

<h3 id="文件快照">文件快照</h3>

<p>在许多情况下,获取文件快照可能很方便。 例如,许多API都期望使用{{domxref("Blob")}}或{{domxref("File")}}对象,例如{{domxref("FileReader")}}(易于使用) 读取整个文件)或{{domxref("XMLHttpRequest")}}。</p>
<p>在许多情况下,获取文件快照可能很方便。例如,许多 API 都期望使用{{domxref("Blob")}}或{{domxref("File")}}对象,例如{{domxref("FileReader")}}(易于使用)读取整个文件)或{{domxref("XMLHttpRequest")}}。</p>

<p>可以使用{{domxref("FileHandle.getFile","getFile")}}获得一个{{domxref("File")}}对象,该对象代表{{domxref("FileHandle")}}对象处理的文件的当前状态方法。 这样的{{domxref("File")}}对象与原始文件完全不同步,这意味着对该对象所做的任何更改将永远不会反映到已处理文件中,并且对已处理文件所做的任何更改也将永远不会被反映。 推送到{{domxref("File")}}对象。</p>
<p>可以使用{{domxref("FileHandle.getFile","getFile")}}获得一个{{domxref("File")}}对象,该对象代表{{domxref("FileHandle")}}对象处理的文件的当前状态方法。这样的{{domxref("File")}}对象与原始文件完全不同步,这意味着对该对象所做的任何更改将永远不会反映到已处理文件中,并且对已处理文件所做的任何更改也将永远不会被反映。推送到{{domxref("File")}}对象。</p>

<pre class="brush: js notranslate">var mySnapshot = null;
var request = myFileHandle.getFile();
Expand All @@ -127,7 +127,7 @@ <h3 id="文件快照">文件快照</h3>

<h3 id="管理进度">管理进度</h3>

<p>来自{{domxref("LockedFile")}}接口的所有方法都返回一个{{domxref("FileRequest")}}对象。 这样的对象基本上是具有额外功能的{{domxref("DOMRequest")}}:它可以监视操作的进度。 有时读写操作可能会很长,因此最好监视该操作以向用户提供反馈。 可以使用{{domxref("FileRequest.onprogress")}}事件处理程序来完成此类监视。</p>
<p>来自{{domxref("LockedFile")}}接口的所有方法都返回一个{{domxref("FileRequest")}}对象。这样的对象基本上是具有额外功能的{{domxref("DOMRequest")}}:它可以监视操作的进度。有时读写操作可能会很长,因此最好监视该操作以向用户提供反馈。可以使用{{domxref("FileRequest.onprogress")}}事件处理程序来完成此类监视。</p>

<pre class="brush: js notranslate">var progress = document.querySelector('progress');
var myFile = myFileHandle.open('readonly');
Expand All @@ -153,7 +153,7 @@ <h3 id="管理进度">管理进度</h3>

<h2 id="文件储存">文件储存</h2>

<p>创建文件句柄时,只要您持有{{domxref("FileHandle")}}实例,关联文件就仅作为“临时文件”存在。 如果您希望文件在页面刷新/应用重新启动后仍然存在,则需要将句柄存储在数据库中(不一定是用于创建{{domxref("FileHandle")}} object)。</p>
<p>创建文件句柄时,只要您持有{{domxref("FileHandle")}}实例,关联文件就仅作为“临时文件”存在。如果您希望文件在页面刷新/应用重新启动后仍然存在,则需要将句柄存储在数据库中(不一定是用于创建{{domxref("FileHandle")}} object)。</p>

<pre class="brush: js notranslate">var IDBReq = window.indexedDB.open('myFileStorageDataBase');

Expand Down Expand Up @@ -183,7 +183,7 @@ <h2 id="文件储存">文件储存</h2>
}
</pre>

<p>以这种方式存储的文件将物理地放置在设备上。数据库本身仅存储指向该文件的指针。这意味着,如果{{domxref("FileHandle")}} 对象在多个DB或多个数据存储中存储了几次,则所有这些对象都将引用同一个唯一文件。这不是问题,因为要访问文件,需要一个{domxref("LockedFile")}}对象,并且对该对象的操作是独立执行的,这意味着一旦{{domxref("LockedFile")}} 在激活状态下,保证此 {{domxref("LockedFile")}} 的所有操作在基础文件上顺序发生,而不会与其他{{domxref("LockedFile")}}的操作交错。</p>
<p>以这种方式存储的文件将物理地放置在设备上。数据库本身仅存储指向该文件的指针。这意味着,如果{{domxref("FileHandle")}} 对象在多个 DB 或多个数据存储中存储了几次,则所有这些对象都将引用同一个唯一文件。这不是问题,因为要访问文件,需要一个{domxref("LockedFile")}}对象,并且对该对象的操作是独立执行的,这意味着一旦{{domxref("LockedFile")}} 在激活状态下,保证此 {{domxref("LockedFile")}} 的所有操作在基础文件上顺序发生,而不会与其他{{domxref("LockedFile")}}的操作交错。</p>

<h3 id="安全的写操作">安全的写操作</h3>

Expand All @@ -209,7 +209,7 @@ <h3 id="安全的写操作">安全的写操作</h3>
console.log('Something goes wrong in the writing process: ' + this.error);
}</pre>

<h2 id="API兼容性">API兼容性</h2>
<h2 id="API兼容性">API 兼容性</h2>

<h3 id="Why_a_different_API_than_FileWriter">Why a different API than FileWriter?</h3>

Expand Down
Loading