Skip to content

Commit afd5d5e

Browse files
docs(cn): translate reference/rules/react-calls-components-and-hooks.md into Chinese
优化翻译
1 parent 258667e commit afd5d5e

File tree

1 file changed

+16
-17
lines changed

1 file changed

+16
-17
lines changed

src/content/reference/rules/react-calls-components-and-hooks.md

Lines changed: 16 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,15 @@ title: React 调用组件和 Hook
33
---
44

55
<Intro>
6-
React 负责在必要时渲染组件和 Hook,以优化用户体验。它是声明式的:你只需要告诉 React 在你的组件逻辑中渲染什么,React 会找出向用户展示的最佳方式
6+
React 负责在必要时渲染组件和 Hook,以优化用户体验。它是声明式的:你只需要告诉 React 在你的组件逻辑中渲染什么,React 会决定最佳的渲染方式以展示给用户
77
</Intro>
88

99
<InlineToc />
1010

1111
---
1212

1313
## 绝不要直接调用组件函数 {/*never-call-component-functions-directly*/}
14-
组件应该只在 JSX 中使用。不要将它们作为常规函数调用。React 应该来调用它们
14+
组件应该仅在 JSX 中被使用。不要将它们作为普通函数调用。应该由 React 来调用它们
1515

1616
React 必须决定何时调用你的组件函数 [在渲染过程中](/reference/rules/components-and-hooks-must-be-pure#how-does-react-run-your-code)。在 React 中,你通过 JSX 来实现这一点。
1717

@@ -27,29 +27,29 @@ function BlogPost() {
2727
}
2828
```
2929

30-
如果组件包含 Hook,在循环或条件语句中直接调用组件时,很容易违反 [Hook 的规则](/reference/rules/rules-of-hooks)
30+
如果组件包含 Hook,在循环或条件语句中直接调用它们时,很容易违反 [Hook 的规则](/reference/rules/rules-of-hooks)
3131

3232
让 React 来协调渲染还允许许多好处:
3333

3434
* **组件不仅仅是函数**。 React 可以通过 Hook 向它们添加特性,如与组件在树中身份相关联的局部状态。
35-
* **组件类型参与协调**。通过让 React 调用你的组件,你也告诉它更多关于你的树的概念结构。例如,当你从渲染 `<Feed>` 转移到 `<Profile>` 页面时,React不会尝试重用它们。
36-
* **React 可以提升你的用户体验**。 例如,它可以允许浏览器在组件调用之间做一些工作,这样重新渲染大型组件树就不会阻塞主线程。
37-
* **更好的调试体验**。 如果组件在库中被视为“一等公民”,我们可以围绕这些组件构建丰富的开发者工具,以便在开发过程中进行检查和理解程序内部结构和状态的过程
38-
* **更高效的协调**。 React 可以决定树中哪些组件需要重新渲染,并跳过不需要的组件。这使你的应用程序更快,更灵敏
35+
* **组件类型参与协调**。通过让 React 来调用你的组件,你也向它展示了你的组件树的概念结构。。例如,当你从渲染 `<Feed>` 转移到 `<Profile>` 页面时,React不会尝试重用它们。
36+
* **React 可以提升你的用户体验**。 例如,它可以在组件调用期间中断,允许浏览器执行一些工作,这样重新渲染大型组件树就不会阻塞主线程。
37+
* **更好的调试体验**。 如果组件在库中被视为“一等公民”,我们可以围绕这些组件构建丰富的开发者工具,以便在开发过程中进行检查和理解程序内部结构和状态
38+
* **更高效的协调**。 React 可以决定树中哪些组件需要重新渲染,并跳过那些无需重新渲染的组件。使得你的应用程序运行更快,响应更敏捷
3939

4040
---
4141

42-
## 绝不要像常规值一样传递 Hook {/*never-pass-around-hooks-as-regular-values*/}
42+
## 绝不要像传递常规值一样传递 Hook {/*never-pass-around-hooks-as-regular-values*/}
4343

4444
Hook 只能在组件或 Hook 内部调用。永远不要像常规值一样传递它们。
4545

46-
Hook 允许你用 React 特性增强组件。它们应该始终作为函数调用,永远不要作为常规值传递。这使得局部推理成为可能,或者开发者可以通过单独查看组件来理解组件可以做的所有事情的能力
46+
Hooks 允许你为组件添加 React 的特性。它们应该始终作为函数来调用,而绝不能作为常规值传递。这使得局部推理成为可能,即开发者可以通过单独审视一个组件,就能理解该组件所能执行的所有操作
4747

48-
违反这条规则将导致 React 无法自动优化你的组件。
48+
违反此规则将导致 React 无法自动优化你的组件。
4949

50-
### 不要动态地修改 Hook {/*dont-dynamically-mutate-a-hook*/}
50+
### 不要在运行时动态修改 Hook {/*dont-dynamically-mutate-a-hook*/}
5151

52-
Hook 应该尽可能地“静态”。这意味着你不应该动态地修改它们。例如,这意味着你不应该编写高阶 Hook
52+
Hook 应当尽可能保持“静态”。这意味着你不应该动态地改变它们。例如,这意味着你不应该编写高阶 Hook
5353

5454
```js {2}
5555
function ChatInput() {
@@ -58,7 +58,7 @@ function ChatInput() {
5858
}
5959
```
6060

61-
Hook 应该是不可变的,不应该被修改。与其动态地修改 Hook,不如创建一个具有所需功能的静态版本的 Hook。
61+
Hook 应该是不可变的,不应被动态改变。与其动态地变异一个Hooks,不如在创建时就定义一个包含所需功能的静态版本的 Hook。
6262

6363
```js {2,6}
6464
function ChatInput() {
@@ -72,15 +72,15 @@ function useDataWithLogging() {
7272

7373
### 不要动态地使用 Hook {/*dont-dynamically-use-hooks*/}
7474

75-
Hook 也不应该被动态使用:例如,不要通过将 Hook 作为值传递来进行组件的依赖注入:
75+
Hook 也不应该被动态使用:例如,不应该通过将 Hook 作为值传递来在一个组件中实现依赖注入。
7676

7777
```js {2}
7878
function ChatInput() {
7979
return <Button useData={useDataWithLogging} /> // 🔴 Bad: don't pass hooks as props
8080
}
8181
```
8282

83-
你应该始终将 Hook 的调用内联到那个组件中,并在那里处理任何逻辑
83+
你应该始终将 Hook 的调用内联到组件内部,并在其中处理任何逻辑
8484

8585
```js {6}
8686
function ChatInput() {
@@ -97,5 +97,4 @@ function useDataWithLogging() {
9797
}
9898
```
9999

100-
这样,`<Button />` 更容易理解并调试。当 Hook 以动态方式使用时,它大大增加了你的应用程序的复杂性,并抑制了局部推理,这从长远来看使你的团队生产力降低。它还更容易意外地违反 [Hook 的规则](/reference/rules/rules-of-hooks),即 Hook 不应该被条件性地调用。如果你发现自己需要为测试模拟组件,最好是模拟服务器以响应罐装数据。如果可能,通常进行端到端测试你的应用程序也是更有效的。
101-
100+
这样,`<Button />` 组件更容易理解也更易于调试。当 Hook 以动态方式使用时,会大大增加应用的复杂性,并妨碍局部推理,这从长远来看会降低团队的生产力。它还更容易意外地违反 [Hook 的规则](/reference/rules/rules-of-hooks),即 Hook 不应该被条件性地调用。如果你发现自己需要为测试而模拟组件,最好是模拟服务器以响应预设数据。如果可能,通常进行端到端测试你的应用也是更有效的方法。

0 commit comments

Comments
 (0)