diff --git a/content/docs/hooks-intro.md b/content/docs/hooks-intro.md index f380ecf62b..dfc2c7b298 100644 --- a/content/docs/hooks-intro.md +++ b/content/docs/hooks-intro.md @@ -25,9 +25,9 @@ function Example() { } ``` -`useState` 是我们要学习的第一个 “Hook”,这个例子是简单演示。如果不理解也不用担心。 +`useState` 是第一个我们要学习的 “Hook”,这个例子只是个简单演示,如果没理解也不用担心。 -**你将在[下一章节](/docs/hooks-overview.html)正式开始学习 Hook。** 这一章节,我们将会解释为什么会在 React 中加入 Hook,以及如何使用 Hook 写出更好的应用。 +**你将在[下一章节](/docs/hooks-overview.html)正式开始学习 Hook。** 在本章,我们将会解释为什么会在 React 中加入 Hook,以及如何使用 Hook 写出更好的应用。 >注意 > @@ -46,31 +46,31 @@ function Example() { 在我们继续之前,请记住 Hook 是: -* **完全可选的。** 你无需重写任何已有代码就可以在一些组件中尝试 Hook。但是如果你不想,你不必现在就去学习或使用 Hook。 -* **100% 向后兼容的。** Hook 不包含任何破坏性改动。 -* **现在可用。** Hook 已发布于 v16.8.0。 +* **完全可选的。** 如果你想在你现有的项目里使用 Hook ,你可以在不需要修改任何现有的代码就可以直接使用。但如果不想用的话 ,还可以暂时不需要去学习。 +* **100% 向后兼容。** Hook 对于老版本没有任何破坏性改动。 +* **现在可用** Hook 已发布于 v16.8.0。 -**没有计划从 React 中移除 class。** 你可以在本页[底部的章节](#gradual-adoption-strategy)读到更多关于 Hook 的渐进策略。 +**没有计划从 React 中移除 class。** 你可以在 [本章末尾] (#gradual-adoption-strategy)读到更多关于 Hook 的渐进策略。 -**Hook 不会影响你对 React 概念的理解。** 恰恰相反,Hook 为已知的 React 概念提供了更直接的 API:props, state,context,refs 以及生命周期。稍后我们将看到,Hook 还提供了一种更强大的方式来组合他们。 +**Hook 不会影响你对 React 概念的理解。** 恰恰相反,Hook 为已知的 React 概念提供了更直接的 API:props, state,context,refs 以及生命周期。稍后我们将看到,随着我们的展开,Hooks将会提供一个全新有力的方式去结合它。 -**如果不想了解添加 Hook 的具体原因,可以直接[跳到下一章节开始学习 Hook!](/docs/hooks-overview.html)** 当然你也可以继续阅读这一章节来了解原因,并且可以学习到如何在不重写应用的情况下使用 Hook。 +**如果不想了解添加 Hook 的具体原因,可以直接 [跳到下一章节开始学习 Hook!](/docs/hooks-overview.html)** 当然你也可以继续阅读这一章节来了解原因,并且可以学习到如何在不重写应用的情况下使用 Hook。 ## 动机 {#motivation} -Hook 解决了我们五年来编写和维护成千上万的组件时遇到的各种各样看起来不相关的问题。无论你正在学习 React,或每天使用,或者更愿尝试另一个和 React 有相似组件模型的框架,你都可能对这些问题似曾相识。 +Hook 解决了在过去的使用 react 五年里编写和维护成百上千的组件时遇到的各种各样看似与 react 无关的问题。无论你正在学习 React,或每天使用,或者更愿尝试另一个和 React 有相似组件模型的框架,你都可能对这些问题似曾相识。 -### 在组件之间复用状态逻辑很难 {#its-hard-to-reuse-stateful-logic-between-components} +### 在组件之间很难复用状态逻辑 {#its-hard-to-reuse-stateful-logic-between-components} -React 没有提供将可复用性行为“附加”到组件的途径(例如,把组件连接到 store)。如果你使用过 React 一段时间,你也许会熟悉一些解决此类问题的方案,比如 [render props](/docs/render-props.html) 和 [高阶组件](/docs/higher-order-components.html)。但是这类方案需要重新组织你的组件结构,这可能会很麻烦,使你的代码难以理解。如果你在 React DevTools 中观察过 React 应用,你会发现由 providers,consumers,高阶组件,render props 等其他抽象层组成的组件会形成“嵌套地狱”。尽管我们可以[在 DevTools 过滤掉它们](https://github.com/facebook/react-devtools/pull/503),但这说明了一个更深层次的问题:React 需要为共享状态逻辑提供更好的原生途径。 +React 没有提供将可复用性行为“附加”到组件上去(例如,把组件连接到 store)。如果你使用过 React 一段时间,你也许会熟悉一些解决此类问题的方案,比如 [render props](/docs/render-props.html) 和 [高阶组件](/docs/higher-order-components.html)。但是这类方案需要你当你需要使用时重构你已有的组件,这将会很麻烦并且会让代码难以理解,如果你在 React DevTools 中观察过传统的 React 应用,你会发现由 providers,consumers,高阶组件,render props 等其他抽象层组成的组件会形成“嵌套地狱”。尽管我们可以[在 DevTools 过滤掉它们](https://github.com/facebook/react-devtools/pull/503),但这说明了一个更深层次的问题:React 需要为共享状态逻辑提供更好的原生途径。 -你可以使用 Hook 从组件中提取状态逻辑,使得这些逻辑可以单独测试并复用。**Hook 使你在无需修改组件结构的情况下复用状态逻辑。** 这使得在组件间或社区内共享 Hook 变得更便捷。 +在Hooks中,你可以单独提取状态逻辑进行单独的测试和复用。**Hook 使你在无需修改现有组件结构代码的情况下在任意层级复用状态逻辑。** 这使得在组件间和团队内共享 Hook 变得更便捷。 具体将在[自定义 Hook](/docs/hooks-custom.html) 中对此展开更多讨论。 ### 复杂组件变得难以理解 {#complex-components-become-hard-to-understand} -我们经常维护一些组件,组件起初很简单,但是逐渐会被状态逻辑和副作用充斥。每个生命周期常常包含一些不相关的逻辑。例如,组件常常在 `componentDidMount` 和 `componentDidUpdate` 中获取数据。但是,同一个 `componentDidMount` 中可能也包含很多其它的逻辑,如设置事件监听,而之后需在 `componentWillUnmount` 中清除。相互关联且需要对照修改的代码被进行了拆分,而完全不相关的代码却在同一个方法中组合在一起。如此很容易产生 bug,并且导致逻辑不一致。 +我们经常维护一些组件,组件起初很简单,但是逐渐会被状态逻辑和副作用充斥。每个生命周期常常包含一些互不相关的逻辑。例如,组件通常在 `componentDidMount` 和 `componentDidUpdate` 中获取组建需要的数据。但是,同一个 `componentDidMount` 中可能也包含很多跟获取数据不相关的逻辑,如设置事件监听,随后需要在 `componentWillUnmount` 中卸载这个事件。相互关联且需要对照修改的代码被进行了拆分,而完全不相关的代码却在同一个方法中组合在一起。如此很容易产生 bug,并且导致逻辑不一致。 在多数情况下,不可能将组件拆分为更小的粒度,因为状态逻辑无处不在。这也给测试带来了一定挑战。同时,这也是很多人将 React 与状态管理库结合使用的原因之一。但是,这往往会引入了很多抽象概念,需要你在不同的文件之间来回切换,使得复用变得更加困难。 @@ -80,7 +80,7 @@ React 没有提供将可复用性行为“附加”到组件的途径(例如 ### 难以理解的 class {#classes-confuse-both-people-and-machines} -除了代码复用和代码管理会遇到困难外,我们还发现 class 是学习 React 的一大屏障。你必须去理解 JavaScript 中 `this` 的工作方式,这与其他语言存在巨大差异。还不能忘记绑定事件处理器。如果不使用 [ES2022 public class fields](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes/Public_class_fields#public_instance_fields),这些代码非常冗余。大家可以很好地理解 props,state 和自顶向下的数据流,但对 class 却一筹莫展。即便在有经验的 React 开发者之间,对于函数组件与 class 组件的差异也存在分歧,甚至还要区分两种组件的使用场景。 +除了代码复用和难以维护的缺点,我们还发现 class 是学习 React 的一大屏障。你需要理解 JavaScript 中 `this` 的工作方式,这与其他语言存在巨大差异。还不能忘记绑定事件处理器。如果不使用 [ES2022 public class fields](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes/Public_class_fields#public_instance_fields),这些代码非常冗余。大家可以很好地理解 props,state 和自顶向下 的数据流,但对 class 却一筹莫展。即便在有经验的 React 开发者之间,对于函数组件与 class 组件的差异也存在分歧,甚至还要区分两种组件的使用场景。 另外,React 已经发布五年了,我们希望它能在下一个五年也与时俱进。就像 [Svelte](https://svelte.dev/),[Angular](https://angular.io/),[Glimmer](https://glimmerjs.com/)等其它的库展示的那样,组件[预编译](https://en.wikipedia.org/wiki/Ahead-of-time_compilation)会带来巨大的潜力。尤其是在它不局限于模板的时候。最近,我们一直在使用 [Prepack](https://prepack.io/) 来试验 [component folding](https://github.com/facebook/react/issues/7323),也取得了初步成效。但是我们发现使用 class 组件会无意中鼓励开发者使用一些让优化措施无效的方案。class 也给目前的工具带来了一些问题。例如,class 不能很好的压缩,并且会使热重载出现不稳定的情况。因此,我们想提供一个使代码更易于优化的 API。 @@ -100,7 +100,7 @@ React 没有提供将可复用性行为“附加”到组件的途径(例如 **最重要的是,Hook 和现有代码可以同时工作,你可以渐进式地使用他们。** 不用急着迁移到 Hook。我们建议避免任何“大规模重写”,尤其是对于现有的、复杂的 class 组件。开始“用 Hook 的方式思考”前,需要做一些思维上的转变。按照我们的经验,最好先在新的不复杂的组件中尝试使用 Hook,并确保团队中的每一位成员都能适应。在你尝试使用 Hook 后,欢迎给我们提供[反馈](https://github.com/facebook/react/issues/new),无论好坏。 -我们准备让 Hook 覆盖所有 class 组件的使用场景,但是**我们将继续为 class 组件提供支持。**在 Facebook,我们有成千上万的组件用 class 书写,我们完全没有重写它们的计划。相反,我们开始在新的代码中同时使用 Hook 和 class。 +我们准备让 Hook 覆盖所有 class 组件的使用场景,但是**我们将继续为 class 组件提供支持。**在 Facebook,我们有成千上万的组件是用 class 书写的,我们完全没有重写它们的计划。相反,我们将会在新的需求里开始使用 hooks ,让他们和现有的 class 同时工作。 ## FAQ {#frequently-asked-questions}