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/web/api/r*/ #5907

Merged
merged 2 commits into from
Jun 3, 2022
Merged
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
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/readablestream/getreader/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ getReader(mode)

## 示例

下面是个简单的例子, 在读取 `ReadableStream` 前,使用 `getReader()` 创建一个 {{domxref("ReadableStreamDefaultReader")}}。(查看全部代码:[Simple random stream example](https://mdn.github.io/dom-examples/streams/simple-random-stream/))。按顺序读取每个块,并传递给 UI, 当整个流被读取完毕后, 从递归方法中退出,并在 UI 的另一部分输出整个流。
下面是个简单的例子在读取 `ReadableStream` 前,使用 `getReader()` 创建一个 {{domxref("ReadableStreamDefaultReader")}}。(查看全部代码:[Simple random stream example](https://mdn.github.io/dom-examples/streams/simple-random-stream/))。按顺序读取每个块,并传递给 UI当整个流被读取完毕后从递归方法中退出,并在 UI 的另一部分输出整个流。

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

<p><a href="https://developer.mozilla.org/zh-CN/docs/Web/API/Streams_API">流操作API</a> 中的<code>ReadableStream</code> 接口呈现了一个可读取的二进制流操作。<a href="https://developer.mozilla.org/zh-CN/docs/Web/API/Fetch_API">Fetch API</a> 通过 {{domxref("Response")}} 的属性 {{domxref("Body.body", "body")}} 提供了一个具体的 <code>ReadableStream</code> 对象。</p>
<p><a href="https://developer.mozilla.org/zh-CN/docs/Web/API/Streams_API">流操作 API</a> 中的<code>ReadableStream</code> 接口呈现了一个可读取的二进制流操作。<a href="https://developer.mozilla.org/zh-CN/docs/Web/API/Fetch_API">Fetch API</a> 通过 {{domxref("Response")}} 的属性 {{domxref("Body.body", "body")}} 提供了一个具体的 <code>ReadableStream</code> 对象。</p>

<h2 id="构造函数">构造函数</h2>

Expand Down Expand Up @@ -47,14 +47,14 @@ <h2 id="方法">方法</h2>
<dt>{{domxref("ReadableStream.pipeTo()")}}</dt>
<dd>将当前 ReadableStream 管道输出到给定的 {{domxref("WritableStream")}},并返回一个 promise,输出过程成功时返回 fulfilled,在发生错误时返回 rejected。</dd>
<dt>{{domxref("ReadableStream.tee()")}}</dt>
<dd><code>tee</code> 方法(tee本意是将高尔夫球放置在球座上)<a href="https://streams.spec.whatwg.org/#tee-a-readable-stream" id="ref-for-tee-a-readable-stream②">tees</a> 了可读流,返回包含两个{{domxref("ReadableStream")}} 实例分支的数组,每个元素接收了相同的传输数据。</dd>
<dd><code>tee</code> 方法(tee 本意是将高尔夫球放置在球座上)<a href="https://streams.spec.whatwg.org/#tee-a-readable-stream" id="ref-for-tee-a-readable-stream②">tees</a> 了可读流,返回包含两个{{domxref("ReadableStream")}} 实例分支的数组,每个元素接收了相同的传输数据。</dd>
<dt>{{domxref("ReadableStream[@@asyncIterator]()")}}</dt>
<dd><code>getIterator</code> 方法的别名。</dd>
</dl>

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

<p>下面的例子,创建了一个智能的 {{domxref("Response")}} 来流式化从别的资源处取得的HTML 片段。</p>
<p>下面的例子,创建了一个智能的 {{domxref("Response")}} 来流式化从别的资源处取得的 HTML 片段。</p>

<p>它演示了 {{domxref("ReadableStream")}} 与 {{domxref("Uint8Array")}} 的协同用法。</p>

Expand All @@ -64,7 +64,7 @@ <h2 id="示例">示例</h2>
start(controller) {
// 下面的函数处理每个数据块
function push() {
// "done"是一个布尔型,"value"是一个Uint8Array
// "done"是一个布尔型,"value"是一个 Uint8Array
reader.read().then(({ done, value }) =&gt; {
// 判断是否还有可读的数据?
if (done) {
Expand All @@ -73,7 +73,7 @@ <h2 id="示例">示例</h2>
return;
}

// 取得数据并将它通过controller发送给浏览器
// 取得数据并将它通过 controller 发送给浏览器
controller.enqueue(value);
push();
});
Expand Down
16 changes: 8 additions & 8 deletions files/zh-cn/web/api/readablestream/readablestream/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<div>{{SeeCompatTable}}{{APIRef("Streams")}}</div>

<p><strong><code>ReadableStream()</code></strong> 构造器创建并返回包含处理函数的可读流实例.</p>
<p><strong><code>ReadableStream()</code></strong> 构造器创建并返回包含处理函数的可读流实例</p>

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

Expand All @@ -15,18 +15,18 @@ <h3 id="参数">参数</h3>

<dl>
<dt>underlyingSource</dt>
<dd>一个包含定义了构造流行为方法和属性的对象.<code>underlyingSource</code> 包括:
<dd>一个包含定义了构造流行为方法和属性的对象<code>underlyingSource</code> 包括
<dl>
<dt>start(controller)</dt>
<dd>这是一个当对象被构造时立刻调用的方法.此方法的内容由开发人员定义,并应着眼于访问流,并执行其他任何必需的设置流功能.如果这个过程是异步完成的,它可以返回一个promise,表明成功或失败.传递给这个方法的<code>controller</code>是一个{{domxref("ReadableStreamDefaultController")}}或{{domxref("ReadableByteStreamController")}},具体取决于<code>type</code>属性的值。开发人员可以使用此方法在设立期间控制流.</dd>
<dd>这是一个当对象被构造时立刻调用的方法此方法的内容由开发人员定义,并应着眼于访问流并执行其他任何必需的设置流功能如果这个过程是异步完成的,它可以返回一个 promise,表明成功或失败传递给这个方法的<code>controller</code>是一个{{domxref("ReadableStreamDefaultController")}}或{{domxref("ReadableByteStreamController")}},具体取决于<code>type</code>属性的值。开发人员可以使用此方法在设立期间控制流</dd>
<dt>pull(controller) {{optional_inline}}</dt>
<dd>这个方法,也是由开发人员定义的,当流的内部队列不满时,会重复调用这个方法,直到队列补满。如果<code>pull()</code>返回一个promise,那么它将不会再被调用,直到promise完成;如果promise失败,该流将会出现错误.传递给此方法的<code>controller</code>参数是{{domxref("ReadableStreamDefaultController")}}或{{domxref("ReadableByteStreamController")}},具体取决于<code>type</code>属性的值。由于更多的块被获取,这个方法可以被开发人员用来控制流.</dd>
<dd>这个方法,也是由开发人员定义的,当流的内部队列不满时,会重复调用这个方法,直到队列补满。如果<code>pull()</code>返回一个 promise,那么它将不会再被调用,直到 promise 完成;如果 promise 失败,该流将会出现错误传递给此方法的<code>controller</code>参数是{{domxref("ReadableStreamDefaultController")}}或{{domxref("ReadableByteStreamController")}},具体取决于<code>type</code>属性的值。由于更多的块被获取这个方法可以被开发人员用来控制流</dd>
<dt>cancel(reason) {{optional_inline}}</dt>
<dd>如果应用程序表示该流将被取消(例如,调用了{{domxref("ReadableStream.cancel()")}},则将调用此方法,该方法也由开发人员定义。 该方法应该做任何必要的事情来释放对流的访问。 如果这个过程是异步的,它可以返回一个promise,表明成功或失败.原因参数包含一个{{domxref("DOMString")}},它描述了流被取消的原因.</dd>
<dd>如果应用程序表示该流将被取消(例如调用了{{domxref("ReadableStream.cancel()")}},则将调用此方法,该方法也由开发人员定义。 该方法应该做任何必要的事情来释放对流的访问。 如果这个过程是异步的,它可以返回一个 promise,表明成功或失败原因参数包含一个{{domxref("DOMString")}},它描述了流被取消的原因</dd>
<dt>type {{optional_inline}}</dt>
<dd>该属性控制正在处理的可读类型的流。如果它包含一个设置为<code>bytes</code>的值,则传递的控制器对象将是一个{{domxref("ReadableByteStreamController")}},能够处理BYOB(带您自己的缓冲区)/字节流。如果未包含,则传递的控制器将为{{domxref("ReadableStreamDefaultController")}}。</dd>
<dd>该属性控制正在处理的可读类型的流。如果它包含一个设置为<code>bytes</code>的值,则传递的控制器对象将是一个{{domxref("ReadableByteStreamController")}},能够处理 BYOB(带您自己的缓冲区)/字节流。如果未包含,则传递的控制器将为{{domxref("ReadableStreamDefaultController")}}。</dd>
<dt>autoAllocateChunkSize {{optional_inline}}</dt>
<dd>对于字节流,开发人员可以使用正整数值设置<code>autoAllocateChunkSize</code> 以打开流的自动分配功能。启用此功能后,流实现将自动分配一个具有给定整数大小的{{domxref("ArrayBuffer")}},并调用底层源代码,就好像消费者正在使用BYOB阅读器一样。</dd>
<dd>对于字节流,开发人员可以使用正整数值设置<code>autoAllocateChunkSize</code> 以打开流的自动分配功能。启用此功能后,流实现将自动分配一个具有给定整数大小的{{domxref("ArrayBuffer")}},并调用底层源代码,就好像消费者正在使用 BYOB 阅读器一样。</dd>
</dl>
</dd>
<dt>queueingStrategy {{optional_inline}}</dt>
Expand All @@ -46,7 +46,7 @@ <h3 id="参数">参数</h3>

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

<p>{{domxref("ReadableStream")}}对象的实例.</p>
<p>{{domxref("ReadableStream")}}对象的实例</p>

<h3 id="错误">错误</h3>

Expand Down
16 changes: 8 additions & 8 deletions files/zh-cn/web/api/readablestreamdefaultreader/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,39 +6,39 @@
<p>{{APIRef("Streams")}}{{SeeCompatTable}}</p>

<p><br>
 <a href="/en-US/docs/Web/API/Streams_API">Streams API</a> 的 <strong>ReadableStreamDefaultReader </strong>的接口 表示一个可被用于读取来自网络提供的流数据(例如 fetch 请求)的默认读取器</p>
 <a href="/en-US/docs/Web/API/Streams_API">Streams API</a> 的 <strong>ReadableStreamDefaultReader </strong>的接口 表示一个可被用于读取来自网络提供的流数据 (例如 fetch 请求) 的默认读取器</p>

<h2 id="构造方法">构造方法</h2>

<dl>
<dt><a href="https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultReader/ReadableStreamDefaultReader" title="ReadableStreamDefaultReader()构造函数创建并返回一个ReadableStreamDefaultReader()对象实例。"><code>ReadableStreamDefaultReader()</code></a></dt>
<dd>创建 和 返回 一个 <code>ReadableStreamDefaultReader()</code> 对象实例.</dd>
<dd>创建 和 返回 一个 <code>ReadableStreamDefaultReader()</code> 对象实例</dd>
</dl>

<h2 id="属性">属性</h2>

<dl>
<dt><a href="https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultReader/closed" title="ReadableStream接口的封闭getter属性返回一个承诺,如果流关闭或读取器的锁被释放,则返回承诺;如果流错误则拒绝。"><code>ReadableStreamDefaultReader.closed</code></a><br>
   </dt>
<dd>允许你编写 当stream结束时 执行的代码 . 如果这个stream变成关闭状态或者 reader 的锁(lock)被释放 则返回一个状态是 fulfills的 promise,如果这个stream 报错则返回rejects的promise.</dd>
<dd>允许你编写 当 stream 结束时 执行的代码 . 如果这个 stream 变成关闭状态或者 reader 的锁 (lock) 被释放 则返回一个状态是 fulfills 的 promise,如果这个 stream 报错则返回 rejects 的 promise.</dd>
</dl>

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

<dl>
<dt><a href="https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultReader/cancel" title="ReadableStreamDefaultReader接口的cancel()方法取消流,表示消费者对流中兴趣的丧失。 所提供的理由参数将被提供给潜在的来源,可能会或可能不会使用它。"><code>ReadableStreamDefaultReader.cancel()</code></a></dt>
<dd>取消这个 stream, 表示对这个stream失去了兴趣. 提供的参数将传递给源source, 可能会也可能不会用到这些参数.</dd>
<dd>取消这个 stream,表示对这个 stream 失去了兴趣。提供的参数将传递给源 source,可能会也可能不会用到这些参数</dd>
<dt><a href="https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultReader/read" title="ReadableStreamDefaultReader接口的read()方法返回一个承诺,提供对流内部队列中下一个块的访问。"><code>ReadableStreamDefaultReader.read()</code></a></dt>
<dd>返回一个promise,提供对stream内部队列中下一个块(chunk)访问的promise.</dd>
<dd>返回一个 promise,提供对 stream 内部队列中下一个块 (chunk) 访问的 promise.</dd>
<dt><a href="https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultReader/releaseLock" title="ReadableStreamDefaultReader接口的releaseLock()方法释放读取器对流的锁定。"><code>ReadableStreamDefaultReader.releaseLock()</code></a></dt>
<dd>释放读取这个stream的锁.</dd>
<dd>释放读取这个 stream 的锁。</dd>
</dl>

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

<p>在下面的例子中, {{domxref("Response")}} 被创建为流 HTML片段 fetched 来自其他源.</p>
<p>在下面的例子中{{domxref("Response")}} 被创建为流 HTML 片段 fetched 来自其他源</p>

<p>它展示了一个 {{domxref("ReadableStream")}} 和一个 <a href="https://developer.mozilla.org/en-US/docs/Web/API/Uint8Array" title="有关这方面的文件尚未编写; 请考虑贡献!"><code>Uint8Array</code></a>组合使用的例子.</p>
<p>它展示了一个 {{domxref("ReadableStream")}} 和一个 <a href="https://developer.mozilla.org/en-US/docs/Web/API/Uint8Array" title="有关这方面的文件尚未编写; 请考虑贡献!"><code>Uint8Array</code></a>组合使用的例子</p>

<pre class="brush: js">fetch("https://www.example.org/").then((response) =&gt; {
  const reader = response.body.getReader();
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/renderingcontext/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
---
<p>{{APIRef("Canvas API")}}</p>

<p><code><strong>RenderingContext</strong></code> 是一个辅助类型,描述下面任何一个渲染上下文:  {{domxref("CanvasRenderingContext2D")}}, {{domxref("WebGLRenderingContext")}} 或者 {{domxref("WebGL2RenderingContext")}} (继承自 <code>WebGLRenderingContext</code>)。</p>
<p><code><strong>RenderingContext</strong></code> 是一个辅助类型,描述下面任何一个渲染上下文:  {{domxref("CanvasRenderingContext2D")}}, {{domxref("WebGLRenderingContext")}} 或者 {{domxref("WebGL2RenderingContext")}}(继承自 <code>WebGLRenderingContext</code>)。</p>

<p>这是简化规范的辅助类型,它不是一个接口,也没有对象实现它。</p>

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

<p>Resize Observer API提供了一种高性能的机制,通过该机制,代码可以监视元素的大小更改,并且每次大小更改时都会向观察者传递通知。</p>
<p>Resize Observer API 提供了一种高性能的机制,通过该机制,代码可以监视元素的大小更改,并且每次大小更改时都会向观察者传递通知。</p>

<h2 id="概念和使用">概念和使用</h2>

Expand All @@ -17,7 +17,7 @@ <h2 id="概念和使用">概念和使用</h2>

<p>这样的解决方案仅适用于有限的场景,对性能不利(不断调用上述方法会导致性能严重下降),并且在不更改浏览器窗口大小的情况下通常不起作用。</p>

<p>Resize Observer API提供了一种解决此类问题的解决方案,此外,它还使您能够轻松观察和响应元素内容或边框的大小变化,并以高效的方式做出响应。 它为Web平台中经常讨论的缺少<a href="https://www.xanthir.com/b4PR0">element queries</a> 提供了JavaScript解决方案。</p>
<p>Resize Observer API 提供了一种解决此类问题的解决方案,此外,它还使您能够轻松观察和响应元素内容或边框的大小变化,并以高效的方式做出响应。 它为 Web 平台中经常讨论的缺少<a href="https://www.xanthir.com/b4PR0">element queries</a> 提供了 JavaScript 解决方案。</p>

<p>用法很简单,并且与其他观察者(例如 <a href="/en-US/docs/Web/API/PerformanceObserver">Performance Observer</a> 或者 <a href="/en-US/docs/Web/API/Intersection_Observer_API">Intersection Observer</a> )— 几乎相同,您可以使用 <code><a href="/en-US/docs/Web/API/ResizeObserver/ResizeObserver">ResizeObserver()</a></code>构造函数创建一个新的{{domxref("ResizeObserver")}} ,然后使用 {{domxref("ResizeObserver.observe()")}}使其寻找特定元素大小的更改。 每次更改大小时,构造函数中设置的回调函数便会运行,从而提供对新维度的访问权限,并允许您根据需要执行任何操作。</p>

Expand All @@ -32,11 +32,11 @@ <h2 id="接口">接口</h2>

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

<p>您可以在我们的GitHub存储库中找到几个简单的示例:</p>
<p>您可以在我们的 GitHub 存储库中找到几个简单的示例:</p>

<ul>
<li><a href="https://mdn.github.io/dom-examples/resize-observer/resize-observer-border-radius.html">resize-observer-border-radius.html</a> (<a href="https://github.com/mdn/dom-examples/blob/master/resize-observer/resize-observer-border-radius.html">源码</a>): 一个带有绿色框的简单示例,其大小为视口大小的百分比。更改视口大小时,框的圆角将根据框的大小成比例地变化。 我们可以通过 {{cssxref("border-radius")}} 来百分比来实现,但这很快会导致椭圆形的角看起来很丑陋,而上述解决方案为您提供了随盒子大小缩放的漂亮的角形正方形。</li>
<li><a href="https://mdn.github.io/dom-examples/resize-observer/resize-observer-text.html">resize-observer-text.html</a> (<a href="https://github.com/mdn/dom-examples/blob/master/resize-observer/resize-observer-text.html">源码</a>): 这里我们使用resize observer来改变 {{cssxref("font-size")}} ,标题和段落的值随着滑块值的改变而改变,导致包含的&lt;div&gt;改变宽度。 这表明您可以响应元素大小的更改,即使它们与视口无关。</li>
<li><a href="https://mdn.github.io/dom-examples/resize-observer/resize-observer-text.html">resize-observer-text.html</a> (<a href="https://github.com/mdn/dom-examples/blob/master/resize-observer/resize-observer-text.html">源码</a>): 这里我们使用 resize observer 来改变 {{cssxref("font-size")}} ,标题和段落的值随着滑块值的改变而改变,导致包含的&lt;div&gt;改变宽度。 这表明您可以响应元素大小的更改,即使它们与视口无关。</li>
</ul>

<p>代码通常将遵循这种模式 (取自 resize-observer-border-radius.html):</p>
Expand Down Expand Up @@ -74,7 +74,7 @@ <h2 id="技术规范">技术规范</h2>

<h2 id="浏览器支持情况">浏览器支持情况</h2>

<p>此页面中的兼容性表是根据结构化数据生成的。如果你想贡献数据,请到 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 提PR。</p>
<p>此页面中的兼容性表是根据结构化数据生成的。如果你想贡献数据,请到 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 提 PR。</p>

<p>{{Compat("api.ResizeObserver")}}</p>

Expand Down
Loading