Skip to content

Commit 9f09ed7

Browse files
oceanlvrKimYangOfCatNeo42KnowsCountTinaaaaP
authored
[Beta] docs(cn): translate render-and-commit into Chinese (#686)
Co-authored-by: Kim Yang <Kim.Yang.GH@outlook.com> Co-authored-by: Hao Jiang ᛋ <22409868+Neo42@users.noreply.github.com> Co-authored-by: KnowsCount <knowscount@gmail.com> Co-authored-by: Tina Pu <t2pu@uwaterloo.ca>
1 parent b5b5baf commit 9f09ed7

File tree

1 file changed

+61
-55
lines changed

1 file changed

+61
-55
lines changed

beta/src/pages/learn/render-and-commit.md

Lines changed: 61 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,50 @@
11
---
2-
title: Render and Commit
2+
title: 渲染和提交
3+
translators:
4+
- oceanlvr
5+
- KimYangOfCat
6+
- Neo42
7+
- TinaaaaP
8+
- KnowsCount
39
---
410

511
<Intro>
612

7-
Before your components are displayed on screen, they must be rendered by React. Understanding the steps in this process will help you think about how your code executes and explain its behavior.
13+
组件显示到屏幕之前,其必须被 React 渲染。理解这些处理步骤将帮助您思考代码的执行过程并能解释其行为。
814

915
</Intro>
1016

1117
<YouWillLearn>
1218

13-
* What rendering means in React
14-
* When and why React renders a component
15-
* The steps involved in displaying a component on screen
16-
* Why rendering does not always produce a DOM update
19+
* React 中渲染的含义是什么
20+
* 为什么以及什么时候 React 会渲染一个组件
21+
* 在屏幕上显示组件所涉及的步骤
22+
* 为什么渲染并不一定会导致 DOM 更新
1723

1824
</YouWillLearn>
1925

20-
Imagine that your components are cooks in the kitchen, assembling tasty dishes from ingredients. In this scenario, React is the waiter who puts in requests from customers and brings them their orders. This process of requesting and serving UI has three steps:
26+
想象一下,您的组件是厨房里的厨师,把食材烹制成美味的菜肴。在这种场景下,React 就是一名服务员,他会帮客户们下单并为他们送来所点的菜品。这种请求和提供 UI 的过程总共包括三个步骤:
2127

22-
1. **Triggering** a render (delivering the guest's order to the kitchen)
23-
2. **Rendering** the component (getting the order from the kitchen)
24-
3. **Committing** to the DOM (placing the order on the table)
28+
1. **触发** 一次渲染(把客人的点单分发到厨房)
29+
2. **渲染** 组件(从厨房取得所点的菜品)
30+
3. **提交** DOM(将菜品放在桌子上)
2531

2632
<IllustrationBlock sequential>
27-
<Illustration caption="Trigger" alt="React as a server in a restaurant, fetching orders from the users and delivering them to the Component Kitchen." src="/images/docs/illustrations/i_render-and-commit1.png" />
28-
<Illustration caption="Render" alt="The Card Chef gives React a fresh Card component." src="/images/docs/illustrations/i_render-and-commit2.png" />
29-
<Illustration caption="Commit" alt="React delivers the Card to the user at their table." src="/images/docs/illustrations/i_render-and-commit3.png" />
33+
<Illustration caption="触发" alt="React 作为餐厅里的服务员,从用户那里获取点单并把它们分发到组件厨房。" src="/images/docs/illustrations/i_render-and-commit1.png" />
34+
<Illustration caption="渲染" alt="Card 主厨交给 React 一个新鲜的 Card 组件。" src="/images/docs/illustrations/i_render-and-commit2.png" />
35+
<Illustration caption="提交" alt="React Card 送到用户桌上。" src="/images/docs/illustrations/i_render-and-commit3.png" />
3036
</IllustrationBlock>
3137

32-
## Step 1: Trigger a render {/*step-1-trigger-a-render*/}
38+
## 步骤 1: 触发一次渲染 {/*step-1-trigger-a-render*/}
3339

34-
There are two reasons for a component to render:
40+
有两种原因会导致组件的渲染:
3541

36-
1. It's the component's **initial render.**
37-
2. The component's **state has been updated.**
42+
1. 组件的 **初次渲染。**
43+
2. 组件的 **状态发生了改变。**
3844

39-
### Initial render {/*initial-render*/}
45+
### 初次渲染 {/*initial-render*/}
4046

41-
When your app starts, you need to trigger the initial render. Frameworks and sandboxes sometimes hide this code, but it's done by calling `ReactDOM.render` with your root component and the target DOM node:
47+
当应用启动时,会触发初次渲染。框架和沙箱有时会隐藏这部分代码,但这是通过使用根组件和目标 DOM 节点调用 `ReactDOM.render` 来达成的:
4248

4349
<Sandpack>
4450

@@ -65,36 +71,36 @@ export default function Image() {
6571

6672
</Sandpack>
6773

68-
Try commenting out the `ReactDOM.render` call and see the component disappear!
74+
试着注释掉 `ReactDOM.render`,然后您将会看到组件消失。
6975

70-
### Re-renders when state updates {/*re-renders-when-state-updates*/}
76+
### 状态更新时重新渲染 {/*re-renders-when-state-updates*/}
7177

72-
Once the component has been initially rendered, you can trigger further renders by updating its state with [`setState`](reference/setstate). Updating your component's state automatically queues a render. (You can imagine these as a restaurant guest ordering tea, dessert, and all sorts of things after putting in their first order, depending on the state of their thirst or hunger.)
78+
一旦组件被初次渲染,您就可以通过使用 [`setState`](reference/setstate) 更新其状态来触发之后的渲染。更新组件的状态会自动将一次渲染送入队列。(您可以想象这种情况成餐厅客人在第一次下单之后又点了茶、点心和各种东西,具体取决于他们的胃口。)
7379

7480
<IllustrationBlock sequential>
75-
<Illustration caption="State update..." alt="React as a server in a restaurant, serving a Card UI to the user, represented as a patron with a cursor for their head. They patron expresses they want a pink card, not a black one!" src="/images/docs/illustrations/i_rerender1.png" />
76-
<Illustration caption="...triggers..." alt="React returns to the Component Kitchen and tells the Card Chef they need a pink Card." src="/images/docs/illustrations/i_rerender2.png" />
77-
<Illustration caption="...render!" alt="The Card Chef gives React the pink Card." src="/images/docs/illustrations/i_rerender3.png" />
81+
<Illustration caption="状态更新..." alt="React 作为餐厅服务员将一份 Card UI 送到用户那里,这里的用户以头部为光标的顾客表示。顾客说她想要一个粉色的 Card,而不是黑色的。" src="/images/docs/illustrations/i_rerender1.png" />
82+
<Illustration caption="...触发..." alt="React 回到组件厨房并告诉 Card 主厨他们需要一个粉色 Card" src="/images/docs/illustrations/i_rerender2.png" />
83+
<Illustration caption="...渲染!" alt="Card 主厨把粉色 Card 交给 React。" src="/images/docs/illustrations/i_rerender3.png" />
7884
</IllustrationBlock>
7985

80-
## Step 2: React renders your components {/*step-2-react-renders-your-components*/}
86+
## 步骤 2: React 渲染您的组件 {/*step-2-react-renders-your-components*/}
8187

82-
After you trigger a render, React calls your components to figure out what to display on screen. **"Rendering" is React calling your components.**
88+
在您触发渲染后,React 会调用您的组件来确定要在屏幕上显示的内容。**"渲染中" 即 React 在调用您的组件。**
8389

84-
* **On initial render,** React will call the root component.
85-
* **For subsequent renders,** React will call the function component whose state update triggered the render.
90+
* **在进行初次渲染时,** React 会调用根组件。
91+
* **对于后续的渲染,** React 会调用内部状态更新触发了渲染的函数组件。
8692

87-
This process is recursive: if the updated component returns some other component, React will render _that_ component next, and if that component also returns something, it will render _that_ component next, and so on. The process will continue until there are no more nested components and React knows exactly what should be displayed on screen.
93+
这个过程是递归的:如果更新后的组件会返回某个另外的组件,那么 React 接下来就会渲染 _那个_ 组件,而如果那个组件又返回了某个组件,那么 React 接下来就会渲染 _那个_ 组件,以此类推。这个过程会持续下去,直到没有更多的嵌套组件并且 React 确切知道哪些东西应该显示到屏幕上为止。
8894

89-
In the following example, React will call `Gallery()` and `Image()` several times:
95+
在接下来的例子中,React 将会调用 `Gallery()` `Image()` 若干次:
9096

9197
<Sandpack>
9298

9399
```js Gallery.js active
94100
export default function Gallery() {
95101
return (
96102
<section>
97-
<h1>Inspiring Sculptures</h1>
103+
<h1>鼓舞人心的雕塑</h1>
98104
<Image />
99105
<Image />
100106
<Image />
@@ -128,34 +134,34 @@ img { margin: 0 10px 10px 0; }
128134

129135
</Sandpack>
130136

131-
* **During the initial render,** React will [create the DOM nodes](https://developer.mozilla.org/docs/Web/API/Document/createElement) for `<section>`, `<h1>`, and three `<img>` tags.
132-
* **During a re-render,** React will calculate which of their properties, if any, have changed since the previous render. It won't do anything with that information until the next step, the commit phase.
137+
* **在初次渲染中,** React 将会为`<section>``<h1>` 和三个 `<img>` 标签 [创建 DOM 节点](https://developer.mozilla.org/docs/Web/API/Document/createElement)
138+
* **在一次重渲染过程中,** React 将计算它们的哪些属性(如果有的话)自上次渲染以来已更改。在下一步(提交阶段)之前,它不会对这些信息执行任何操作。
133139

134140
<Gotcha>
135141

136-
Rendering must always be a [pure calculation](/learn/keeping-components-pure):
142+
渲染必须始终是一次 [纯计算](/learn/keeping-components-pure):
137143

138-
* **Same inputs, same output.** Given the same inputs, a component should always return the same JSX. (When someone orders a salad with tomatoes, they should not receive a salad with onions!)
139-
* **Mind its own business.** It should not change any objects or variables that existed before rendering. (One order should not change anyone else's order.)
144+
* **输入相同,输出相同。** 给定相同的输入,组件应始终返回相同的 JSX。(当有人点了西红柿沙拉时,他们不应该收到洋葱沙拉!)
145+
* **管好它自己的事情。** 它不应更改任何存在于渲染之前的对象或变量。(一个订单不应更改其他任何人的订单。)
140146

141-
Otherwise, you can encounter confusing bugs and unpredictable behavior as your codebase grows in complexity. When developing in "Strict Mode," React calls each component's function twice, which can help surface mistakes caused by impure functions.
147+
否则,随着代码库复杂性的增加,您可能会遇到令人困惑的错误和不可预测的行为。在"严格模式"下开发时,React 会调用每个组件的函数两次,这可以帮助发现由不纯函数引起的错误。
142148

143149
</Gotcha>
144150

145-
<DeepDive title="Optimizing performance">
151+
<DeepDive title="性能优化">
146152

147-
The default behavior of rendering all components nested within the updated component is not optimal for performance if the updated component is very high in the tree. If you run into a performance issue, there are several opt-in ways to solve it described in the [Performance](/learn/performance) section. **Don't optimize prematurely!**
153+
如果更新的组件在树中的位置非常高,渲染更新后的组件内部所有嵌套组件的默认行为将不会获得最佳性能。如果您遇到了性能问题,[性能](/learn/performance) 章节描述了几种可选的解决方案 。**不要过早进行优化!**
148154

149155
</DeepDive>
150156

151-
## Step 3: React commits changes to the DOM {/*step-3-react-commits-changes-to-the-dom*/}
157+
## 步骤 3: React 把更改提交到 DOM {/*step-3-react-commits-changes-to-the-dom*/}
152158

153-
After rendering (calling) your components, React will modify the DOM.
159+
在渲染(调用)您的组件之后,React 将会修改 DOM
154160

155-
* **For the initial render,** React will use the [`appendChild()`](https://developer.mozilla.org/docs/Web/API/Node/appendChild) DOM API to put all the DOM nodes it has created on screen.
156-
* **For re-renders,** React will apply the minimal necessary operations (calculated while rendering!) to make the DOM match the latest rendering output.
161+
* **对于初次渲染,** React 会使用 [`appendChild()`](https://developer.mozilla.org/docs/Web/API/Node/appendChild) DOM API 将其创建的所有 DOM 节点放在屏幕上。
162+
* **对于重渲染,** React 将应用最少的必要操作(在渲染时计算!),以使得 DOM 与最新的渲染输出相互匹配。
157163

158-
**React only changes the DOM nodes if there's a difference between renders.** For example, here is a component that re-renders with different props passed from its parent every second. Notice how you can add some text into the `<input>`, updating its `value`, but the text doesn't disappear when the component re-renders:
164+
**React 仅在渲染之间存在差异时才会更改 DOM 节点。**例如,有一个组件,它每秒使用从父组件传递下来的不同属性重新渲染一次。注意,您可以添加一些文本到 `<input>` 标签,更新它的 `value`,但是文本不会在组件重渲染时消失:
159165

160166
<Sandpack>
161167

@@ -195,21 +201,21 @@ export default function App() {
195201

196202
</Sandpack>
197203

198-
This works because during this last step, React only updates the content of `<h1>` with the new `time`. It sees that the `<input>` appears in the JSX in the same place as last time, so React doesn't touch the `<input>`—or its `value`!
199-
## Epilogue: Browser paint {/*epilogue-browser-paint*/}
204+
这个例子之所以会正常运行,是因为在最后一步中,React 只会使用最新的 `time` 更新 `<h1>` 标签的内容。它看到 `<input>` 标签出现在 JSX 中与上次相同的位置,因此 React 不会修改 `<input>` 标签或它的 `value`
205+
## 尾声:浏览器绘制 {/*epilogue-browser-paint*/}
200206

201-
After rendering is done and React updated the DOM, the browser will repaint the screen. Although this process is known as "browser rendering", we'll refer to it as "painting" to avoid confusion in the rest of these docs.
207+
在渲染完成并且 React 更新 DOM 之后,浏览器就会重新绘制屏幕。尽管这个过程被称为“浏览器渲染”(“browser rendering”),但我们还是将它称为“绘制”(“painting”),以避免在这些文档的其余部分中出现混淆。
202208

203-
<Illustration alt="A browser painting 'still life with card element'." src="/images/docs/illustrations/i_browser-paint.png" />
209+
<Illustration alt="浏览器正在绘制《静物:Card 元素》" src="/images/docs/illustrations/i_browser-paint.png" />
204210

205211
<Recap>
206212

207-
* Any screen update in a React app happens in three steps:
208-
1. Trigger
209-
2. Render
210-
3. Commit
211-
* You can use Strict Mode to find mistakes in your components
212-
* React does not touch the DOM if the rendering result is the same as last time
213+
* 在一个 React 应用中一次屏幕更新都会发生以下三个步骤:
214+
1. 触发
215+
2. 渲染
216+
3. 提交
217+
* 您可以使用严格模式去找到组件中的错误
218+
* 如果渲染结果与上次一样,那么 React 将不会修改 DOM
213219

214220
</Recap>
215221

0 commit comments

Comments
 (0)