From c31265b66e86e6a404d85c4b77fe14352b200020 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BE=90=E6=A0=A1=E9=95=B7?= Date: Sat, 16 Feb 2019 01:19:31 +0800 Subject: [PATCH 01/17] docs(cn): translate content/docs/reference-react-dom-server.md into Chinese --- content/docs/reference-react-dom-server.md | 43 +++++++++++----------- 1 file changed, 21 insertions(+), 22 deletions(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 80c0303775..5cb32148f6 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -6,7 +6,7 @@ category: Reference permalink: docs/react-dom-server.html --- -The `ReactDOMServer` object enables you to render components to static markup. Typically, it's used on a Node server: +`ReactDOMServer` 类允许你将组件渲染成静态标记。通常，它被使用在 Node 服务端上： ```js // ES modules @@ -15,21 +15,21 @@ import ReactDOMServer from 'react-dom/server'; var ReactDOMServer = require('react-dom/server'); ``` -## Overview {#overview} +## 概览 {#overview} -The following methods can be used in both the server and browser environments: +下面的方法可以被使用在服务端和浏览器环境。 - [`renderToString()`](#rendertostring) - [`renderToStaticMarkup()`](#rendertostaticmarkup) -These additional methods depend on a package (`stream`) that is **only available on the server**, and won't work in the browser. +下面这些附加的方法依赖一个**只能在服务端使用**的 package（`stream`）。它们在浏览器中不起作用。 - [`renderToNodeStream()`](#rendertonodestream) - [`renderToStaticNodeStream()`](#rendertostaticnodestream) * * * -## Reference {#reference} +## 参考 {#reference} ### `renderToString()` {#rendertostring} @@ -37,9 +37,9 @@ These additional methods depend on a package (`stream`) that is **only available ReactDOMServer.renderToString(element) ``` -Render a React element to its initial HTML. React will return an HTML string. You can use this method to generate HTML on the server and send the markup down on the initial request for faster page loads and to allow search engines to crawl your pages for SEO purposes. +将一个 React 元素渲染成其初始 HTML。React 会返回一个 HTML 字符串。你可以使用本方法在服务器上生成 HTML，并在初始请求时将标记下发，以加快页面加载速度，并允许搜索引擎抓取你的页面以达到 SEO 优化的目的。 -If you call [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on a node that already has this server-rendered markup, React will preserve it and only attach event handlers, allowing you to have a very performant first-load experience. +如果你在一个已经有了服务端渲染标记的节点上调用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 方法，React 将会保留该节点并仅作绑定事件处理，从而让你有一个非常高性能的首次加载体验。 * * * @@ -49,9 +49,9 @@ If you call [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on a node that ReactDOMServer.renderToStaticMarkup(element) ``` -Similar to [`renderToString`](#rendertostring), except this doesn't create extra DOM attributes that React uses internally, such as `data-reactroot`. This is useful if you want to use React as a simple static page generator, as stripping away the extra attributes can save some bytes. +本方法与 [`renderToString`](#rendertostring) 相似，除了本方法不会创建在 React 内部使用的额外 DOM 属性，例如 `data-reactroot`。如果你希望把 React 当作一个静态页面生成器来使用，本方法会非常有用，因为除去额外的属性可以节省一些字节。 -If you plan to use React on the client to make the markup interactive, do not use this method. Instead, use [`renderToString`](#rendertostring) on the server and [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on the client. +如果你计划在前端使用 React 以使得标记可交互，不要使用本方法。作为代替，在服务端上使用 [`renderToString`](#rendertostring) 和在前端上使用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate)。 * * * @@ -61,15 +61,15 @@ If you plan to use React on the client to make the markup interactive, do not us ReactDOMServer.renderToNodeStream(element) ``` -Render a React element to its initial HTML. Returns a [Readable stream](https://nodejs.org/api/stream.html#stream_readable_streams) that outputs an HTML string. The HTML output by this stream is exactly equal to what [`ReactDOMServer.renderToString`](#rendertostring) would return. You can use this method to generate HTML on the server and send the markup down on the initial request for faster page loads and to allow search engines to crawl your pages for SEO purposes. +将一个 React 元素渲染成其初始 HTML。返回一个可输出 HTML 字符串的 [可读流](https://nodejs.org/api/stream.html#stream_readable_streams)。通过可读流输出的 HTML，完全等同于 [`ReactDOMServer.renderToString`](#rendertostring) 返回的 HTML。你可以使用本方法在服务器上生成 HTML，并在初始请求时将标记下发，以加快页面加载速度，并允许搜索引擎抓取你的页面以达到 SEO 优化的目的。 -If you call [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on a node that already has this server-rendered markup, React will preserve it and only attach event handlers, allowing you to have a very performant first-load experience. +如果你在一个已经有了服务端渲染标记的节点上调用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 方法，React 将会保留该节点并仅作绑定事件处理，从而让你有一个非常高性能的首次加载体验。 -> Note: +> 注意: > -> Server-only. This API is not available in the browser. -> -> The stream returned from this method will return a byte stream encoded in utf-8. If you need a stream in another encoding, take a look at a project like [iconv-lite](https://www.npmjs.com/package/iconv-lite), which provides transform streams for transcoding text. +> 这个 API 仅允许在服务端使用。不允许在浏览器使用。 +> 通过本方法返回的流会返回一个由 utf-8 编码的字节流。如果你需要另一种编码的流，请查看像 [iconv-lite](https://www.npmjs.com/package/iconv-lite) 这样的项目，它为转换文本提供了转换流。 + * * * @@ -79,14 +79,13 @@ If you call [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on a node that ReactDOMServer.renderToStaticNodeStream(element) ``` -Similar to [`renderToNodeStream`](#rendertonodestream), except this doesn't create extra DOM attributes that React uses internally, such as `data-reactroot`. This is useful if you want to use React as a simple static page generator, as stripping away the extra attributes can save some bytes. +本方法与 [`renderToNodeStream`](#rendertonodestream) 相似，除了本方法不会创建在 React 内部使用的额外 DOM 属性，例如 `data-reactroot`。如果你希望把 React 当作一个静态页面生成器来使用，本方法会非常有用，因为除去额外的属性可以节省一些字节。 -The HTML output by this stream is exactly equal to what [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup) would return. +通过可读流输出的 HTML，完全等同于 [`ReactDOMServer.renderToString`](#rendertostring) 返回的 HTML。 -If you plan to use React on the client to make the markup interactive, do not use this method. Instead, use [`renderToNodeStream`](#rendertonodestream) on the server and [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on the client. +如果你计划在前端使用 React 以使得标记可交互，不要使用本方法。作为代替，在服务端上使用 [`renderToNodeStream`](#rendertonodestre上) 和在前端上使用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate)。 -> Note: -> -> Server-only. This API is not available in the browser. +> 注意: > -> The stream returned from this method will return a byte stream encoded in utf-8. If you need a stream in another encoding, take a look at a project like [iconv-lite](https://www.npmjs.com/package/iconv-lite), which provides transform streams for transcoding text. +> 这个 API 仅允许在服务端使用。不允许在浏览器使用。 +> 通过本方法返回的流会返回一个由 utf-8 编码的字节流。如果你需要另一种编码的流，请查看像 [iconv-lite](https://www.npmjs.com/package/iconv-lite) 这样的项目，它为转换文本提供了转换流。 From e95c65a0f1a76f83389a23c7425038162a732e10 Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 00:29:28 +0800 Subject: [PATCH 02/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 5cb32148f6..88112c6066 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -6,7 +6,7 @@ category: Reference permalink: docs/react-dom-server.html --- -`ReactDOMServer` 类允许你将组件渲染成静态标记。通常，它被使用在 Node 服务端上： +`ReactDOMServer` 对象允许你将组件渲染成静态标记。通常，它被使用在 Node 服务端上： ```js // ES modules From 589e2ee96c7dfa6d2734715cab125aa3dfc7c560 Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 00:32:12 +0800 Subject: [PATCH 03/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 88112c6066..d9f4f92d23 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -37,7 +37,7 @@ var ReactDOMServer = require('react-dom/server'); ReactDOMServer.renderToString(element) ``` -将一个 React 元素渲染成其初始 HTML。React 会返回一个 HTML 字符串。你可以使用本方法在服务器上生成 HTML，并在初始请求时将标记下发，以加快页面加载速度，并允许搜索引擎抓取你的页面以达到 SEO 优化的目的。 +将 React 元素渲染为初始 HTML。React 将返回一个 HTML 字符串。你可以使用此方法在服务端生成 HTML，并在首次请求时将标记下发，以加快页面加载速度，并允许搜索引擎爬取你的页面以达到 SEO 优化的目的。 如果你在一个已经有了服务端渲染标记的节点上调用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 方法，React 将会保留该节点并仅作绑定事件处理，从而让你有一个非常高性能的首次加载体验。 From 1dff034e641c910123cc2d10a82eda47a4724bc0 Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 00:33:17 +0800 Subject: [PATCH 04/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index d9f4f92d23..6b871534f0 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -63,7 +63,7 @@ ReactDOMServer.renderToNodeStream(element) 将一个 React 元素渲染成其初始 HTML。返回一个可输出 HTML 字符串的 [可读流](https://nodejs.org/api/stream.html#stream_readable_streams)。通过可读流输出的 HTML，完全等同于 [`ReactDOMServer.renderToString`](#rendertostring) 返回的 HTML。你可以使用本方法在服务器上生成 HTML，并在初始请求时将标记下发，以加快页面加载速度，并允许搜索引擎抓取你的页面以达到 SEO 优化的目的。 -如果你在一个已经有了服务端渲染标记的节点上调用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 方法，React 将会保留该节点并仅作绑定事件处理，从而让你有一个非常高性能的首次加载体验。 +如果你在已有服务端渲染标记的节点上调用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 方法，React 将会保留该节点且只进行事件处理绑定，从而让你有一个非常高性能的首次加载体验。 > 注意: > From be9a17630c1f08c02775fc40705dc57a178703a0 Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 00:34:09 +0800 Subject: [PATCH 05/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 6b871534f0..227fcd00a0 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -39,7 +39,7 @@ ReactDOMServer.renderToString(element) 将 React 元素渲染为初始 HTML。React 将返回一个 HTML 字符串。你可以使用此方法在服务端生成 HTML，并在首次请求时将标记下发，以加快页面加载速度，并允许搜索引擎爬取你的页面以达到 SEO 优化的目的。 -如果你在一个已经有了服务端渲染标记的节点上调用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 方法，React 将会保留该节点并仅作绑定事件处理，从而让你有一个非常高性能的首次加载体验。 +如果你在已有服务端渲染标记的节点上调用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 方法，React 将会保留该节点且只进行事件处理绑定，从而让你有一个非常高性能的首次加载体验。 * * * From 89b36c23e6d66b380ba58de94d9f3c13ac8173f6 Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 00:35:44 +0800 Subject: [PATCH 06/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 227fcd00a0..15ffcb0ee7 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -68,6 +68,7 @@ ReactDOMServer.renderToNodeStream(element) > 注意: > > 这个 API 仅允许在服务端使用。不允许在浏览器使用。 +> > 通过本方法返回的流会返回一个由 utf-8 编码的字节流。如果你需要另一种编码的流，请查看像 [iconv-lite](https://www.npmjs.com/package/iconv-lite) 这样的项目，它为转换文本提供了转换流。 From 8fd17f7aac1932417866bd224b7ba22d0f284dfb Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 00:37:50 +0800 Subject: [PATCH 07/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 15ffcb0ee7..d65a45f178 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -61,7 +61,7 @@ ReactDOMServer.renderToStaticMarkup(element) ReactDOMServer.renderToNodeStream(element) ``` -将一个 React 元素渲染成其初始 HTML。返回一个可输出 HTML 字符串的 [可读流](https://nodejs.org/api/stream.html#stream_readable_streams)。通过可读流输出的 HTML，完全等同于 [`ReactDOMServer.renderToString`](#rendertostring) 返回的 HTML。你可以使用本方法在服务器上生成 HTML，并在初始请求时将标记下发，以加快页面加载速度，并允许搜索引擎抓取你的页面以达到 SEO 优化的目的。 +将一个 React 元素渲染成其初始 HTML。返回一个可输出 HTML 字符串的[可读流](https://nodejs.org/api/stream.html#stream_readable_streams)。通过可读流输出的 HTML 完全等同于 [`ReactDOMServer.renderToString`](#rendertostring) 返回的 HTML。你可以使用本方法在服务器上生成 HTML，并在初始请求时将标记下发，以加快页面加载速度，并允许搜索引擎抓取你的页面以达到 SEO 优化的目的。 如果你在已有服务端渲染标记的节点上调用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 方法，React 将会保留该节点且只进行事件处理绑定，从而让你有一个非常高性能的首次加载体验。 From 5a534fd2ea69c16b1602e36b594c78ad24cb57a3 Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 00:38:10 +0800 Subject: [PATCH 08/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index d65a45f178..6ca00fdc38 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -80,7 +80,7 @@ ReactDOMServer.renderToNodeStream(element) ReactDOMServer.renderToStaticNodeStream(element) ``` -本方法与 [`renderToNodeStream`](#rendertonodestream) 相似，除了本方法不会创建在 React 内部使用的额外 DOM 属性，例如 `data-reactroot`。如果你希望把 React 当作一个静态页面生成器来使用，本方法会非常有用，因为除去额外的属性可以节省一些字节。 +此方法与 [`renderToNodeStream`](#rendertonodestream) 相似，但此方法不会在 React 内部创建的额外 DOM 属性，例如 `data-reactroot`。如果你希望把 React 当作静态页面生成器来使用，此方法会非常有用，因为去除额外的属性可以节省一些字节。 通过可读流输出的 HTML，完全等同于 [`ReactDOMServer.renderToString`](#rendertostring) 返回的 HTML。 From 8a2049f654222bf941644821fec094842aaed595 Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 00:38:49 +0800 Subject: [PATCH 09/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 6ca00fdc38..616ad9cbcf 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -82,7 +82,7 @@ ReactDOMServer.renderToStaticNodeStream(element) 此方法与 [`renderToNodeStream`](#rendertonodestream) 相似，但此方法不会在 React 内部创建的额外 DOM 属性，例如 `data-reactroot`。如果你希望把 React 当作静态页面生成器来使用，此方法会非常有用，因为去除额外的属性可以节省一些字节。 -通过可读流输出的 HTML，完全等同于 [`ReactDOMServer.renderToString`](#rendertostring) 返回的 HTML。 +通过可读流输出的 HTML，完全等同于 [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup) 返回的 HTML。 如果你计划在前端使用 React 以使得标记可交互，不要使用本方法。作为代替，在服务端上使用 [`renderToNodeStream`](#rendertonodestre上) 和在前端上使用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate)。 From 0387fe3afc60430b16e3519004749cfd603f1ec3 Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 00:39:02 +0800 Subject: [PATCH 10/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 616ad9cbcf..1d0c295b7e 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -88,5 +88,5 @@ ReactDOMServer.renderToStaticNodeStream(element) > 注意: > -> 这个 API 仅允许在服务端使用。不允许在浏览器使用。 +> 此 API 仅限在服务端使用。不允许在浏览器中使用。 > 通过本方法返回的流会返回一个由 utf-8 编码的字节流。如果你需要另一种编码的流，请查看像 [iconv-lite](https://www.npmjs.com/package/iconv-lite) 这样的项目，它为转换文本提供了转换流。 From 443286a74ab2e4965ee8efeb7317684849649b91 Mon Sep 17 00:00:00 2001 From: PAMPANG Date: Sat, 9 Mar 2019 10:23:57 +0800 Subject: [PATCH 11/17] =?UTF-8?q?fix:=20change=20`=E4=B8=8B=E9=9D=A2?= =?UTF-8?q?=E7=9A=84=E6=96=B9=E6=B3=95`=20->=20`=E4=B8=8B=E8=BF=B0?= =?UTF-8?q?=E6=96=B9=E6=B3=95`?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/docs/reference-react-dom-server.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 1d0c295b7e..3fefbe3685 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -17,12 +17,12 @@ var ReactDOMServer = require('react-dom/server'); ## 概览 {#overview} -下面的方法可以被使用在服务端和浏览器环境。 +下述方法可以被使用在服务端和浏览器环境。 - [`renderToString()`](#rendertostring) - [`renderToStaticMarkup()`](#rendertostaticmarkup) -下面这些附加的方法依赖一个**只能在服务端使用**的 package（`stream`）。它们在浏览器中不起作用。 +下述附加方法依赖一个**只能在服务端使用**的 package（`stream`）。它们在浏览器中不起作用。 - [`renderToNodeStream()`](#rendertonodestream) - [`renderToStaticNodeStream()`](#rendertostaticnodestream) From 6e33f33fc6bc1cea848a0b71b1a5312181b1c223 Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 10:25:16 +0800 Subject: [PATCH 12/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 3fefbe3685..df546cf9ab 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -49,7 +49,7 @@ ReactDOMServer.renderToString(element) ReactDOMServer.renderToStaticMarkup(element) ``` -本方法与 [`renderToString`](#rendertostring) 相似，除了本方法不会创建在 React 内部使用的额外 DOM 属性，例如 `data-reactroot`。如果你希望把 React 当作一个静态页面生成器来使用，本方法会非常有用，因为除去额外的属性可以节省一些字节。 +此方法与 [`renderToString`](#rendertostring) 相似，但此方法不会在 React 内部创建的额外 DOM 属性，例如 `data-reactroot`。如果你希望把 React 当作静态页面生成器来使用，此方法会非常有用，因为去除额外的属性可以节省一些字节。 如果你计划在前端使用 React 以使得标记可交互，不要使用本方法。作为代替，在服务端上使用 [`renderToString`](#rendertostring) 和在前端上使用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate)。 From d6f0b10186463240a94258455639e59355af892e Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 10:31:02 +0800 Subject: [PATCH 13/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index df546cf9ab..9a8469830e 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -51,7 +51,7 @@ ReactDOMServer.renderToStaticMarkup(element) 此方法与 [`renderToString`](#rendertostring) 相似，但此方法不会在 React 内部创建的额外 DOM 属性，例如 `data-reactroot`。如果你希望把 React 当作静态页面生成器来使用，此方法会非常有用，因为去除额外的属性可以节省一些字节。 -如果你计划在前端使用 React 以使得标记可交互，不要使用本方法。作为代替，在服务端上使用 [`renderToString`](#rendertostring) 和在前端上使用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate)。 +如果你计划在前端使用 React 以使得标记可交互，请不要使用此方法。你可以在服务端上使用 [`renderToString`](#rendertostring) 或在前端上使用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 来代替此方法。 * * * From 1debe3ceae2c739684cac53cbf02826dca80f76c Mon Sep 17 00:00:00 2001 From: QiChang Li Date: Sat, 9 Mar 2019 10:31:10 +0800 Subject: [PATCH 14/17] Update content/docs/reference-react-dom-server.md Co-Authored-By: pampang --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 9a8469830e..2017839f47 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -84,7 +84,7 @@ ReactDOMServer.renderToStaticNodeStream(element) 通过可读流输出的 HTML，完全等同于 [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup) 返回的 HTML。 -如果你计划在前端使用 React 以使得标记可交互，不要使用本方法。作为代替，在服务端上使用 [`renderToNodeStream`](#rendertonodestre上) 和在前端上使用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate)。 +如果你计划在前端使用 React 以使得标记可交互，请不要使用此方法。你可以在服务端上使用 [`renderToNodeStream`](#rendertonodestre) 或在前端上使用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 来代替此方法。 > 注意: > From 217e5bf6b1756a9f7156f71cb30fa48a059d3764 Mon Sep 17 00:00:00 2001 From: PAMPANG Date: Sat, 9 Mar 2019 10:35:12 +0800 Subject: [PATCH 15/17] fix: fix typo --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 2017839f47..339b621bb1 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -84,7 +84,7 @@ ReactDOMServer.renderToStaticNodeStream(element) 通过可读流输出的 HTML，完全等同于 [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup) 返回的 HTML。 -如果你计划在前端使用 React 以使得标记可交互，请不要使用此方法。你可以在服务端上使用 [`renderToNodeStream`](#rendertonodestre) 或在前端上使用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 来代替此方法。 +如果你计划在前端使用 React 以使得标记可交互，请不要使用此方法。你可以在服务端上使用 [`renderToNodeStream`](#rendertonodestream) 或在前端上使用 [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) 来代替此方法。 > 注意: > From ddd1aad9de5858142f1ed91db504102b85f59dae Mon Sep 17 00:00:00 2001 From: PAMPANG Date: Sat, 9 Mar 2019 10:53:12 +0800 Subject: [PATCH 16/17] fix: fix typo --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 339b621bb1..79398d1855 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -71,7 +71,6 @@ ReactDOMServer.renderToNodeStream(element) > > 通过本方法返回的流会返回一个由 utf-8 编码的字节流。如果你需要另一种编码的流，请查看像 [iconv-lite](https://www.npmjs.com/package/iconv-lite) 这样的项目，它为转换文本提供了转换流。 - * * * ### `renderToStaticNodeStream()` {#rendertostaticnodestream} @@ -89,4 +88,5 @@ ReactDOMServer.renderToStaticNodeStream(element) > 注意: > > 此 API 仅限在服务端使用。不允许在浏览器中使用。 +> > 通过本方法返回的流会返回一个由 utf-8 编码的字节流。如果你需要另一种编码的流，请查看像 [iconv-lite](https://www.npmjs.com/package/iconv-lite) 这样的项目，它为转换文本提供了转换流。 From 2df1283814ac4db59da9f471907bf38c41d8357a Mon Sep 17 00:00:00 2001 From: PAMPANG Date: Sat, 9 Mar 2019 21:57:31 +0800 Subject: [PATCH 17/17] Update content/docs/reference-react-dom-server.md --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 79398d1855..86e54bdd51 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -87,6 +87,6 @@ ReactDOMServer.renderToStaticNodeStream(element) > 注意: > -> 此 API 仅限在服务端使用。不允许在浏览器中使用。 +> 此 API 仅限于服务端使用，在浏览器中是不可用的。 > > 通过本方法返回的流会返回一个由 utf-8 编码的字节流。如果你需要另一种编码的流，请查看像 [iconv-lite](https://www.npmjs.com/package/iconv-lite) 这样的项目，它为转换文本提供了转换流。