[Beta] docs(cn): translate reference/render.md #632

liu-jin-yi · 2021-11-03T12:32:01Z

No description provided.

beta/src/pages/reference/render.md

Co-authored-by: QiChang Li <github@liqichang.com>

beta/src/pages/reference/render.md

Neo42

发现了一些错误，麻烦看一下 @QC-L

Neo42 · 2021-12-14T06:23:56Z

beta/src/pages/reference/render.md

 ---

 <Intro>

-`render` renders a piece of [JSX](/learn/writing-markup-with-jsx) ("React element") into a browser DOM container node. It instructs React to change the DOM inside of the `container` so that it matches the passed JSX.
+`render` 函数会将 [JSX](/learn/writing-markup-with-jsx)（“React 元素”）渲染到浏览器 DOM 容器节点中。它可以让 React 改变 `container` 中 DOM，使其与传递的 JSX 相匹配。


修改建议：

”它可以让 React 改变 container 中的 DOM“

”所传递的 JSX“

Neo42 · 2021-12-14T06:27:04Z

beta/src/pages/reference/render.md


 </AnatomyStep>

 <AnatomyStep title="DOM container">

-The DOM node you want to render your UI into. The container itself isn’t modified, only its children are.
+用于渲染 UI 界面的 DOM 节点。该容器不能被修改，只能修改它的子节点。


这句明显错了，应该是"该容器本身不会被修改"、”只有其子节点会被修改“

Neo42 · 2021-12-14T06:35:34Z

beta/src/pages/reference/render.md

@@ -38,7 +41,7 @@ render(<App />, container);

 </APIAnatomy>

-In apps fully built with React, you will do this once at the top level of your app--to render the "root" component.
+在完全由 React 构建的应用程序中，你需要在你的应用程序的入口文件执行该操作（渲染 "root" 组件）。


”在完全使用 React 构建的应用程序中，你需要在你应用程序的最顶层执行一次该操作——渲染 "根" 组件。“

with 应该翻译成使用

入口文件 entry file 是 webpack 中的概念，不应该用在这里，因为不是所有 react 应用都是用 webpack 写的，建议按原文直译

Neo42 · 2021-12-14T06:48:18Z

beta/src/pages/reference/render.md

-      <Comment text="Hello!" author="Sophie" />
-      <Comment text="How are you?" author="Sunil" />
+      <Comment text="你好！" author="Sophie" />
+      <Comment text="你是谁？" author="Sunil" />


你好吗？

How are you 不是 who are you

Neo42 · 2021-12-14T06:53:16Z

beta/src/pages/reference/render.md


 <br />


-## Behavior in detail {/*behavior-in-detail*/}
+## 行为细节 {/*behavior-in-detail*/}


behavior 除了可以指行为，还可以指特性，这里译为特性更合适

Neo42 · 2021-12-14T07:12:34Z

beta/src/pages/reference/render.md

@@ -134,9 +137,9 @@ nav ul li { display: inline-block; margin-right: 20px; }

 <br />

-## Updating the rendered tree {/*updating-the-rendered-tree*/}
+## 更新已渲染的 DOM {/*updating-the-rendered-tree*/}


建议改成更新已渲染的树或更新已渲染的组件树，因为组件树是 React 中的，DOM 树是浏览器中的，两者不能混淆，而且下文中有对两者关系的叙述，应该区别清楚，避免增加理解难度

Neo42 · 2021-12-14T07:13:25Z

beta/src/pages/reference/render.md


-The first time you call `render`, any existing DOM elements inside `container` are replaced. If you call `render` again, React will update the DOM as necessary to reflect the latest JSX. React will decide which parts of the DOM can be reused and which need to be recreated by ["matching it up"](/learn/preserving-and-resetting-state) with the previously rendered tree. Calling `render` repeatedly is similar to calling `setState`--in both cases, React avoids unnecessary DOM updates.
+在你第一次调用 `render` 时，`container` 内的任何已有 DOM 元素都会被替换。如果你再次调用 `render` 时，React 将会通过与先前渲染的组件树 ["匹配"](/learn/preserving-and-resetting-state) 的方式，来决定 DOM 的哪些部分可以重用，哪些需要重新创建。重复调用 `render` 与调用 `setState` 效果类似。无论哪种情况，React 都会避免不必要的 DOM 更新。


如果你再次调用 render 的话，React 会为了体现最新的 JSX 而进行必要的 DOM 更新。React 会通过将 DOM 与先前渲染的组件树进行 "匹配" 的方式，来决定 DOM 的哪些部分可以重用，哪些需要重新创建。重复调用 render 与调用 setState 类似——在这两种情况下，React 都会避免不必要的 DOM 更新。

这里”React will update the DOM as necessary to reflect the latest JSX.“漏译了

matching it up 中的 it 指的是 DOM，应该翻译出来

建议把”效果类似“中的”效果“去掉。不应该说两种调用的效果类似，因为本质上 render 是负责挂载组件的而 setState 是负责改变 state 的。只能说在避免不必要的 DOM 更新方面两者是类似的。

Neo42 · 2021-12-14T07:30:29Z

beta/src/pages/reference/render.md


-You can pass a callback as the third argument. React will call it after your component is in the DOM.
+你可以将一个回调函数，作为 `render` 的第三个参数。React 会在你的组件在 DOM 中出现后，调用它。


你可以将一个回调函数作为第三个参数传递给 render。React 会在你的组件在 DOM 中出现后调用它。

pass 漏译了

谓语之前不要加逗号

KimYangOfCat · 2021-12-31T04:59:27Z

@Neo42 你的建议非常中肯，但此 PR 已经merge了，非常建议你能拉取最新的分支，新建分支并做出修改建议后重新提交新的PR，以便问题被更好地 merge

Neo42 · 2022-01-02T12:41:11Z

@Neo42 你的建议非常中肯，但此 PR 已经merge了，非常建议你能拉取最新的分支，新建分支并做出修改建议后重新提交新的PR，以便问题被更好地 merge

@KimYangOfCat 好的，我会尽快提交

Neo42 · 2022-01-03T10:27:03Z

@KimYangOfCat 已提交 pr #703

[Beta]: tramslation reference render.md done

d5127cc

vercel bot deployed to Preview November 3, 2021 12:32 View deployment

liu-jin-yi changed the title ~~[Beta]: tramslation reference render.md done~~ [Beta]: docs(cn) tramslation reference render.md done Nov 4, 2021

liu-jin-yi changed the title ~~[Beta]: docs(cn) tramslation reference render.md done~~ [Beta]: docs(cn) translation reference-render.md done Nov 4, 2021

liu-jin-yi mentioned this pull request Nov 10, 2021

Translation Progress Assignment Claims #602

Open

Merge branch 'main' into translation-api-render

84c6d8c

vercel bot deployed to Preview November 25, 2021 04:03 View deployment

github-actions bot added the beta label Nov 25, 2021

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Outdated Show resolved Hide resolved

Update beta/src/pages/reference/render.md

ddb3ec1

Co-authored-by: QiChang Li <github@liqichang.com>

vercel bot deployed to Preview November 25, 2021 14:14 View deployment

liu-jin-yi and others added 4 commits November 25, 2021 22:14

Update beta/src/pages/reference/render.md

95cccbb

Co-authored-by: QiChang Li <github@liqichang.com>

Update beta/src/pages/reference/render.md

0443114

Co-authored-by: QiChang Li <github@liqichang.com>

Update beta/src/pages/reference/render.md

372bd2f

Co-authored-by: QiChang Li <github@liqichang.com>

Update beta/src/pages/reference/render.md

e157edd

Co-authored-by: QiChang Li <github@liqichang.com>

vercel bot deployed to Preview November 25, 2021 14:16 View deployment

liu-jin-yi and others added 2 commits November 25, 2021 22:17

Update beta/src/pages/reference/render.md

0403b2d

Co-authored-by: QiChang Li <github@liqichang.com>

Update beta/src/pages/reference/render.md

fc1d8f5

Co-authored-by: QiChang Li <github@liqichang.com>

vercel bot deployed to Preview November 25, 2021 14:18 View deployment

liu-jin-yi and others added 4 commits November 25, 2021 22:18

Update beta/src/pages/reference/render.md

2f09ef6

Co-authored-by: QiChang Li <github@liqichang.com>

Update beta/src/pages/reference/render.md

bf495ad

Co-authored-by: QiChang Li <github@liqichang.com>

Update beta/src/pages/reference/render.md

faff25f

Co-authored-by: QiChang Li <github@liqichang.com>

Update beta/src/pages/reference/render.md

f71ffbf

Co-authored-by: QiChang Li <github@liqichang.com>

vercel bot deployed to Preview November 25, 2021 14:21 View deployment

liu-jin-yi and others added 2 commits November 25, 2021 22:21

Update beta/src/pages/reference/render.md

7822a0a

Co-authored-by: QiChang Li <github@liqichang.com>

Update beta/src/pages/reference/render.md

6db8456

Co-authored-by: QiChang Li <github@liqichang.com>

vercel bot deployed to Preview November 25, 2021 14:23 View deployment

liu-jin-yi and others added 2 commits November 25, 2021 22:23

Update beta/src/pages/reference/render.md

4e836e1

Co-authored-by: QiChang Li <github@liqichang.com>

Update beta/src/pages/reference/render.md

52bd7f9

Co-authored-by: QiChang Li <github@liqichang.com>

vercel bot deployed to Preview November 25, 2021 14:25 View deployment

QC-L reviewed Nov 25, 2021

View reviewed changes

beta/src/pages/reference/render.md Show resolved Hide resolved

Update beta/src/pages/reference/render.md

4f6dd7b

vercel bot deployed to Preview November 25, 2021 16:24 View deployment

QC-L approved these changes Nov 25, 2021

View reviewed changes

QC-L changed the title ~~[Beta]: docs(cn) translation reference-render.md done~~ [Beta] docs(cn): translate reference/render.md Nov 25, 2021

QC-L merged commit 36bea19 into reactjs:main Nov 25, 2021

QC-L mentioned this pull request Dec 7, 2021

Tasks of Review #684

Closed

Neo42 reviewed Dec 14, 2021

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[Beta] docs(cn): translate reference/render.md #632

[Beta] docs(cn): translate reference/render.md #632

liu-jin-yi commented Nov 3, 2021

Neo42 left a comment

Neo42 Dec 14, 2021 •

edited

Loading

Neo42 Dec 14, 2021

Neo42 Dec 14, 2021

Neo42 Dec 14, 2021

Neo42 Dec 14, 2021

Neo42 Dec 14, 2021

Neo42 Dec 14, 2021

Neo42 Dec 14, 2021

KimYangOfCat commented Dec 31, 2021 •

edited

Loading

Neo42 commented Jan 2, 2022

Neo42 commented Jan 3, 2022


		The first time you call `render`, any existing DOM elements inside `container` are replaced. If you call `render` again, React will update the DOM as necessary to reflect the latest JSX. React will decide which parts of the DOM can be reused and which need to be recreated by ["matching it up"](/learn/preserving-and-resetting-state) with the previously rendered tree. Calling `render` repeatedly is similar to calling `setState`--in both cases, React avoids unnecessary DOM updates.
		在你第一次调用 `render` 时，`container` 内的任何已有 DOM 元素都会被替换。如果你再次调用 `render` 时，React 将会通过与先前渲染的组件树 ["匹配"](/learn/preserving-and-resetting-state) 的方式，来决定 DOM 的哪些部分可以重用，哪些需要重新创建。重复调用 `render` 与调用 `setState` 效果类似。无论哪种情况，React 都会避免不必要的 DOM 更新。


		You can pass a callback as the third argument. React will call it after your component is in the DOM.
		你可以将一个回调函数，作为 `render` 的第三个参数。React 会在你的组件在 DOM 中出现后，调用它。

[Beta] docs(cn): translate reference/render.md #632

[Beta] docs(cn): translate reference/render.md #632

Conversation

liu-jin-yi commented Nov 3, 2021

Neo42 left a comment

Choose a reason for hiding this comment

Neo42 Dec 14, 2021 • edited Loading

Choose a reason for hiding this comment

Neo42 Dec 14, 2021

Choose a reason for hiding this comment

Neo42 Dec 14, 2021

Choose a reason for hiding this comment

Neo42 Dec 14, 2021

Choose a reason for hiding this comment

Neo42 Dec 14, 2021

Choose a reason for hiding this comment

Neo42 Dec 14, 2021

Choose a reason for hiding this comment

Neo42 Dec 14, 2021

Choose a reason for hiding this comment

Neo42 Dec 14, 2021

Choose a reason for hiding this comment

KimYangOfCat commented Dec 31, 2021 • edited Loading

Neo42 commented Jan 2, 2022

Neo42 commented Jan 3, 2022

Neo42 Dec 14, 2021 •

edited

Loading

KimYangOfCat commented Dec 31, 2021 •

edited

Loading