diff --git a/beta/scripts/generateRedirects.js b/beta/scripts/generateRedirects.js index b6e23b58aa..92c4d9e101 100644 --- a/beta/scripts/generateRedirects.js +++ b/beta/scripts/generateRedirects.js @@ -42,7 +42,7 @@ function writeRedirectsFile(redirects, redirectsFilePath) { * Make sure we dont have the same redirect already */ oldConfigContent.redirects.forEach((data) => { - if(vercelRedirects[data.source]){ + if (vercelRedirects[data.source]) { delete vercelRedirects[data.source]; } }); diff --git a/beta/scripts/headingIDHelpers/validateHeadingIDs.js b/beta/scripts/headingIDHelpers/validateHeadingIDs.js index 535613e7fb..5d400178f1 100644 --- a/beta/scripts/headingIDHelpers/validateHeadingIDs.js +++ b/beta/scripts/headingIDHelpers/validateHeadingIDs.js @@ -17,9 +17,7 @@ function validateHeaderId(line) { const match = /\{\/\*(.*?)\*\/}/.exec(line); const id = match; if (!id) { - console.error( - 'Run yarn fix-headings to generate headings.' - ); + console.error('Run yarn fix-headings to generate headings.'); process.exit(1); } } diff --git a/beta/scripts/headingIDHelpers/walk.js b/beta/scripts/headingIDHelpers/walk.js index 721274e096..54cd500ca3 100644 --- a/beta/scripts/headingIDHelpers/walk.js +++ b/beta/scripts/headingIDHelpers/walk.js @@ -2,10 +2,10 @@ const fs = require('fs'); module.exports = function walk(dir) { let results = []; - /** + /** * If the param is a directory we can return the file */ - if(dir.includes('md')){ + if (dir.includes('md')) { return [dir]; } const list = fs.readdirSync(dir); diff --git a/beta/scripts/headingIdLinter.js b/beta/scripts/headingIdLinter.js index 037e4945f0..6b8f75fc71 100644 --- a/beta/scripts/headingIdLinter.js +++ b/beta/scripts/headingIdLinter.js @@ -1,12 +1,12 @@ const validateHeaderIds = require('./headingIDHelpers/validateHeadingIDs'); const generateHeadingIds = require('./headingIDHelpers/generateHeadingIDs'); -/** +/** * yarn lint-heading-ids --> Checks all files and causes an error if heading ID is missing * yarn lint-heading-ids --fix --> Fixes all markdown file's heading IDs * yarn lint-heading-ids path/to/markdown.md --> Checks that particular file for missing heading ID (path can denote a directory or particular file) * yarn lint-heading-ids --fix path/to/markdown.md --> Fixes that particular file's markdown IDs (path can denote a directory or particular file) -*/ + */ const markdownPaths = process.argv.slice(2); if (markdownPaths.includes('--fix')) { diff --git a/beta/src/pages/learn/preserving-and-resetting-state.md b/beta/src/pages/learn/preserving-and-resetting-state.md index 5497d2e17b..a716968c47 100644 --- a/beta/src/pages/learn/preserving-and-resetting-state.md +++ b/beta/src/pages/learn/preserving-and-resetting-state.md @@ -1,44 +1,48 @@ --- -title: Preserving and Resetting State +title: 对 state 进行保留和重置 +translators: + - YogaLin + - Neo42 + - QC-L --- -State is isolated between components. React keeps track of which state belongs to which component based on their place in the UI tree. You can control when to preserve state and when to reset it between re-renders. +各个组件的 state 是各自独立的。根据组件在 UI 树中的位置,React 可以跟踪哪些 state 属于哪个组件。你可以控制在重新渲染过程中何时对 state 进行保留和重置。 -* How React "sees" component structures -* When React chooses to preserve or reset the state -* How to force React to reset component's state -* How keys and types affect whether the state is preserved +* React 如何“处理”组件结构 +* React 何时选择保留或重置 state +* 如何强制 React 重置组件的 state +* key 和组件类型如何影响 state 是否被保留 -## The UI tree {/*the-ui-tree*/} +## UI 树 {/*the-ui-tree*/} -Browsers use many tree structures to model UI. The [DOM](https://developer.mozilla.org/docs/Web/API/Document_Object_Model/Introduction) represents HTML elements, the [CSSOM](https://developer.mozilla.org/docs/Web/API/CSS_Object_Model) does the same for CSS. There's even an [Accessibility tree](https://developer.mozilla.org/docs/Glossary/Accessibility_tree)! +浏览器使用许多树形结构来为 UI 建立模型。[DOM](https://developer.mozilla.org/docs/Web/API/Document_Object_Model/Introduction) 用于表示 HTML 元素,[CSSOM](https://developer.mozilla.org/docs/Web/API/CSS_Object_Model) 则表示 CSS 元素。甚至还有 [Accessibility tree](https://developer.mozilla.org/docs/Glossary/Accessibility_tree)! -React also uses tree structures to manage and model the UI you make. React makes **UI trees** from your JSX. Then React DOM updates the browser DOM elements to match that UI tree. (React Native translates these trees into elements specific to mobile platforms.) +React 也使用树形结构来对你创造的 UI 进行管理和建模。React 根据你的 JSX 生成 **UI 树**。React DOM 根据 UI 树去更新浏览器的 DOM 元素。(React Native 则将这些 UI 树转译成移动平台上特有的元素。) -From components, React creates a UI tree which React DOM uses to render the DOM +React 会根据组件创建了一棵 UI 树,React DOM 用它来渲染 DOM -## State is tied to a position in the tree {/*state-is-tied-to-a-position-in-the-tree*/} +## state 与树中的某个位置相关联 {/*state-is-tied-to-a-position-in-the-tree*/} -When you give a component state, you might think the state "lives" inside the component. But the state is actually held inside React. React associates each piece of state it's holding with the correct component by where that component sits in the UI tree. +当你为一个组件添加 state 时,你可能会觉得 state “活”在组件内部。但实际上,state 被保存在 React 内部。根据组件在 UI 树中的位置,React 将它所持有的每个 state 与正确的组件关联起来。 -Here, there is only one `` JSX tag, but it's rendered at two different positions: +下面只定义了一个 `` JSX 标签,但将它渲染在了两个不同的位置: @@ -72,7 +76,7 @@ function Counter() { >

{score}

); @@ -102,23 +106,23 @@ label {
-Here's how these look as a tree: +下面是它们的树形结构的样子: -React tree +React 树 -**These are two separate counters because each is rendered at its own position in the tree.** You don't usually have to think about these positions to use React, but it can be useful to understand how it works. +**这是两个独立的 counter,因为它们在树中被渲染在了各自的位置。** 一般情况下你不用去考虑这些位置来使用 React,但知道它们是如何工作会很有用。 -In React, each component on the screen has fully isolated state. For example, if you render two `Counter` components side by side, each of them will get its own, independent, `score` and `hover` states. +在 React 中,屏幕中的每个组件都有完全独立的 state。举个例子,当你并排渲染两个 `Counter` 组件时,它们都会拥有各自独立的 `score` 和 `hover` state。 -Try clicking both counters and notice they don't affect each other: +试试点击两个 counter 你会发现它们互不影响: @@ -151,7 +155,7 @@ function Counter() { >

{score}

); @@ -176,7 +180,7 @@ function Counter() {
-As you can see, when one counter is updated, only the state for that component is updated: +如你所见,当一个计数器被更新时,只有该组件的状态会被更新: @@ -190,7 +194,7 @@ Updating state -React will keep the state around for as long as you render the same component at the same position. To see this, increment both counters, then remove the second component by unchecking "Render the second counter" checkbox, and then add it back by ticking it again: +只有当你在相同的位置渲染相同的组件时,React 才会一直保留着组件的 state。想要验证这一点,可以将两个计数器的值递增,取消勾选 “渲染第二个计数器” 复选框,然后再次勾选它: @@ -211,7 +215,7 @@ export default function App() { setShowB(e.target.checked) }} /> - Render the second counter + 渲染第二个计数器 ); @@ -234,7 +238,7 @@ function Counter() { >

{score}

); @@ -264,35 +268,35 @@ label {
-Notice how the moment you stop rendering the second counter, its state disappears completely. That's because when React removes a component, it destroys its state. +注意,当你停止渲染第二个计数器的那一刻,它的 state 完全消失了。这是因为 React 在移除一个组件时,也会销毁它的 state。 -Deleting a component +删除组件 -When you tick "Render the second counter," a second `Counter` and its state are initialized from scratch (`score = 0`) and added to the DOM. +当你重新勾选“渲染第二个计数器”复选框时,另一个计数器及其 state 将从头开始初始化(`score = 0`)并被添加到 DOM 中。 -Adding a component +添加组件 -**React preserves a component's state for as long as it's being rendered at its position in the UI tree.** If it gets removed, or a different component gets rendered at the same position, React discards its state. +**只要一个组件还被渲染在 UI 树的相同位置,React 就会保留它的 state。** 如果它被移除,或者一个不同的组件被渲染在相同的位置,那么 React 就会丢掉它的 state。 -## Same component at the same position preserves state {/*same-component-at-the-same-position-preserves-state*/} +## 相同位置的相同组件会使得 state 被保留下来 {/*same-component-at-the-same-position-preserves-state*/} -In this example, there are two different `` tags: +在这个例子中,有两个不同的 `` 标签: @@ -316,7 +320,7 @@ export default function App() { setIsFancy(e.target.checked) }} /> - Use fancy styling + 使用好看的样式 ); @@ -342,7 +346,7 @@ function Counter({ isFancy }) { >

{score}

); @@ -377,24 +381,24 @@ label {
-When you tick or clear the checkbox, the counter state does not get reset. Whether `isFancy` is `true` or `false`, you always have a `` as the first child of the `div` returned from the root `App` component: +当你勾选或清空复选框的时候,计数器 state 并没有被重置。不管 `isFancy` 是 `true` 还是 `false`,根组件 `App` 返回的 `div` 的第一个子组件都是 ``: -Updating the `App` state does not reset the `Counter` because `Counter` stays in the same position +更新 `App` 的状态不会重置 `Counter`,因为 `Counter` 始终保持在同一位置。 -It's the same component at the same position, so from React's perspective, it's the same counter. +它是位于相同位置的相同组件,所以对 React 来说,它是同一个计数器。 -Remember that **it's the position in the UI tree--not in the JSX markup--that matters to React!** This component has two `return` clauses with different `` JSX tags inside and outside the `if`: +记住 **对 React 来说重要的是组件在 UI 树中的位置,而不是在 JSX 中的位置!** 这个组件在 `if` 内外有两个`return` 语句,它们带有不同的 `` JSX 标签: @@ -415,7 +419,7 @@ export default function App() { setIsFancy(e.target.checked) }} /> - Use fancy styling + 使用好看的样式 ); @@ -431,7 +435,7 @@ export default function App() { setIsFancy(e.target.checked) }} /> - Use fancy styling + 使用好看的样式 ); @@ -457,7 +461,7 @@ function Counter({ isFancy }) { >

{score}

); @@ -492,15 +496,15 @@ label {
-You might expect the state to reset when you tick checkbox, but it doesn't! This is because **both of these `` tags are rendered at the same position.** React doesn't know where you place the conditions in your function. All it "sees" is the tree you return. In both cases, the `App` component returns a `
` with `` as a first child. This is why React considers them as _the same_ ``. +你可能以为当你勾选复选框的时候 state 会被重置,但它并没有!这是因为 **两个 `` 标签被渲染在了相同的位置。** React 不知道你的函数里是如何进行条件判断的,它只会“看到”你返回的树。在这两种情况下,`App` 组件都会返回一个包裹着 `` 作为第一个子组件的 `div`。这就是 React 认为它们是 _同一个_ `` 的原因。 -You can think of them as having the same "address": the first child of the first child of the root. This is how React matches them up between the previous and next renders, regardless of how you structure your logic. +你可以认为它们有相同的“地址”:根组件的第一个子组件的第一个子组件。不管你的逻辑是怎么组织的,这就是 React 在前后两次渲染之间将它们进行匹配的方式。 -## Different components at the same position reset state {/*different-components-at-the-same-position-reset-state*/} +## 相同位置的不同组件会使 state 重置 {/*different-components-at-the-same-position-reset-state*/} -In this example, ticking the checkbox will replace `` with a `

`: +在这个例子中,勾选复选框会将 `` 替换为一个 `

`: @@ -512,7 +516,7 @@ export default function App() { return (

{isPaused ? ( -

See you later!

+

待会见!

) : ( )} @@ -524,7 +528,7 @@ export default function App() { setIsPaused(e.target.checked) }} /> - Take a break + 休息一下
); @@ -547,7 +551,7 @@ function Counter() { >

{score}

); @@ -577,13 +581,13 @@ label { -Here, you switch between _different_ component types at the same position. Initially, the first child of the `
` contained a `Counter`. But when you swapped in a `p`, React removed the `Counter` from the UI tree and destroyed its state. +示例中,你在相同位置对 _不同_ 的组件类型进行切换。刚开始 `
` 的第一个子组件是一个 `Counter`。但是当你切换成 `p` 时,React 将 `Counter` 从 UI 树中移除了并销毁了它的状态。 -When `Counter` changes to `p`, the `Counter` is deleted and the `p` is added +当 `Counter` 变为 `p` 时,`Counter` 会被移除,同时 `p` 被添加。 @@ -593,13 +597,13 @@ When `Counter` changes to `p`, the `Counter` is deleted and the `p` is added -When switching back, the `p` is deleted and the `Counter` is added +当切换回来时,`p` 会被删除,而 `Counter` 会被添加 -Also, **when you render a different component in the same position, it resets the state of its entire subtree**. To see how this works, increment the counter and then tick the checkbox: +并且,**当你在相同位置渲染不同的组件时,组件的整个子树都会被重置**。要验证这一点,可以增加计数器的值然后勾选复选框: @@ -627,7 +631,7 @@ export default function App() { setIsFancy(e.target.checked) }} /> - Use fancy styling + 使用好看的样式
); @@ -653,7 +657,7 @@ function Counter({ isFancy }) { >

{score}

); @@ -688,13 +692,13 @@ label { -The counter state gets reset when you click the checkbox. Although you render a `Counter`, the first child of the `div` changes from a `div` to a `section`. When the child `div` was removed from the DOM, the whole tree below it (including the `Counter` and its state) was destroyed as well. +当你勾选复选框后计数器的 state 被重置了。虽然你渲染了一个 `Counter`,但是 `div` 的第一个子组件从 `div` 变成了 `section`。当子组件 `div` 从 DOM 中被移除的时候,它底下的整棵树(包含 `Counter` 以及它的 state)也都被销毁了。 -When `section` changes to `div`, the `section` is deleted and the new `div` is added +当 `section` 变为 `div` 时,`section` 会被删除,新的 `div` 被添加 @@ -704,19 +708,19 @@ When `section` changes to `div`, the `section` is deleted and the new `div` is a -When switching back, the `div` is deleted and the new `section` is added +当切换回来时,`div` 会被删除,新的 `section` 被添加 -As a rule of thumb, **if you want to preserve the state between re-renders, the structure of your tree needs to "match up"** from one render to another. If the structure is different, the state gets destroyed because React destroys state when it removes a component from the tree. +一般来说,**如果你想在重新渲染时保留 state,几次渲染中的树形结构就应该相互“匹配”**。结构不同就会导致 state 的销毁,因为 React 会在将一个组件从树中移除时销毁它的 state。 -This is why you should not nest component function definitions. +以下是为什么你不应该把组件函数的定义嵌套起来的原因。 -Here, the `MyTextField` component function is defined *inside* `MyComponent`: +示例中, `MyTextField` 组件被定义在 `MyComponent` *内部*: @@ -742,7 +746,7 @@ export default function MyComponent() { + }}>点击了 {counter} 次 ); } @@ -751,13 +755,13 @@ export default function MyComponent() { -Every time you click the button, the input state disappears! This is because a *different* `MyTextField` function is created for every render of `MyComponent`. You're rendering a *different* component in the same position, so React resets all state below. This leads to bugs and performance problems. To avoid this problem, **always declare component functions at the top level, and don't nest their definitions.** +每次你点击按钮,输入框的 state 都会消失!这是因为每次 `MyComponent` 渲染时都会创建一个 _不同_ 的 `MyTextField` 函数。你在相同位置渲染的是 _不同_ 的组件,所以 React 将其下所有的 state 都重置了。这样会导致 bug 以及性能问题。为了避免这个问题, **永远要将组件定义在最上层并且不要把它们的定义嵌套起来。** -## Resetting state at the same position {/*resetting-state-at-the-same-position*/} +## 在相同位置重置 state {/*resetting-state-at-the-same-position*/} -By default, React preserves state of a component while it stays at the same position. Usually, this is exactly what you want, so it makes sense as the default behavior. But sometimes, you may want to reset a component's state. Consider this app that lets two players keep track of their scores during each turn: +默认情况下,React 会在一个组件保持在同一位置时保留它的 state。通常这就是你想要的,所以把它作为默认特性很合理。但有时候,你可能想要重置一个组件的 state。考虑一下这个应用,它可以让两个玩家在每个回合中记录他们的得分: @@ -776,7 +780,7 @@ export default function Scoreboard() { ); @@ -797,9 +801,9 @@ function Counter({ person }) { onPointerEnter={() => setHover(true)} onPointerLeave={() => setHover(false)} > -

{person}'s score: {score}

+

{person} 的分数:{score}

); @@ -827,19 +831,19 @@ h1 {
-Currently, when you change the player, the score is preserved. The two `Counter`s appear in the same position, so React sees them as *the same* `Counter` whose `person` prop has changed. +目前当你切换玩家时,分数会被保留下来。这两个 `Counter` 出现在相同的位置,所以 React 会认为它们是 _同一个_ `Counter`,只是传了不同的 `person` prop。 -But conceptually, in this app they should be two separate counters. They might appear in the same place in the UI, but one is a counter for Taylor, and another is a counter for Sarah. +但是从概念上讲,这个应用中的两个计数器应该是各自独立的。虽然它们在 UI 中的位置相同,但是一个是 Taylor 的计数器,一个是 Sarah 的计数器。 -There are two ways to reset state when switching between them: +有两个方法可以在它们相互切换时重置 state: -1. Render components in different positions -2. Give each component an explicit identity with `key` +1. 将组件渲染在不同的位置 +2. 使用 `key` 赋予每个组件一个明确的身份 -### Option 1: Rendering a component in different positions {/*option-1-rendering-a-component-in-different-positions*/} +### 方法一:将组件渲染在不同的位置 {/*option-1-rendering-a-component-in-different-positions*/} -If you want these two `Counter`s to be independent, you can render them in two different positions: +你如果想让两个 `Counter` 各自独立的话,可以将它们渲染在不同的位置: @@ -859,7 +863,7 @@ export default function Scoreboard() { ); @@ -880,9 +884,9 @@ function Counter({ person }) { onPointerEnter={() => setHover(true)} onPointerLeave={() => setHover(false)} > -

{person}'s score: {score}

+

{person} 的分数:{score}

); @@ -910,8 +914,8 @@ h1 {
-* Initially, `isPlayerA` is `true`. So the first position contains `Counter` state, and the second one is empty. -* When you click the "Next player" button the first position clears but the second one now contains a `Counter`. +* 起初 `isPlayerA` 的值是 `true`。所以第一个位置包含了 `Counter` 的 state,而第二个位置是空的。 +* 当你点击“下一位玩家”按钮时,第一个位置会被清空,而第二个位置现在包含了一个 `Counter`。 @@ -935,17 +939,17 @@ Clicking "next" again -> Each `Counter`'s state gets destroyed each time its removed from the DOM. This is why they reset every time you click the button. +> 每次一个 `Counter` 被从 DOM 中移除时,它的 state 就会被销毁。这就是每次你点击按钮时它们就会被重置的原因。 -This solution is convenient when you only have a few independent components rendered in the same place. In this example, you only have two, so it's not a hassle to render both separately in the JSX. +这个解决方案在你只有少数几个独立的组件渲染在相同的位置时会很方便。这个例子中只有 2 个组件,所以在 JSX 里将它们分开进行渲染并不麻烦。 -### Option 2: Resetting state with a key {/*option-2-resetting-state-with-a-key*/} +### 方法二:使用 key 来重置 state {/*option-2-resetting-state-with-a-key*/} -There is also another, more generic, way to reset a component's state. +还有另一种更通用的重置组件 state 的方法。 -You might have seen `key`s when [rendering lists](/learn/rendering-lists#keeping-list-items-in-order-with-key). Keys aren't just for lists! You can use keys to make React distinguish between any components. By default, React uses order within the parent ("first counter", "second counter") to discern between components. But keys let you tell React that this is not just a *first* counter, or a *second* counter, but a specific counter--for example, *Taylor's* counter. This way, React will know *Taylor's* counter wherever it appears in the tree! +你可能在 [渲染列表](/learn/rendering-lists#keeping-list-items-in-order-with-key) 时见到过 `key`。但 key 不只可以用于列表!你可以使用 key 来让 React 区分任何组件。默认情况下,React 使用父组件内部的顺序(“第一个计数器”、“第二个计数器”)来区分组件。但是 key 可以让你告诉 React 这不仅仅是 *第一个* 或者 *第二个* 计数器,而且还是一个特定的计数器——例如,*Taylor 的* 计数器。这样无论它出现在树的任何位置, React 都会知道它是 *Taylor 的* 计数器! -In this example, the two ``s don't share state even though they appear in the same place in JSX: +在这个例子中,即使两个 `` 会出现在 JSX 中的同一个位置,它们也不会共享 state: @@ -964,7 +968,7 @@ export default function Scoreboard() { ); @@ -985,9 +989,9 @@ function Counter({ person }) { onPointerEnter={() => setHover(true)} onPointerLeave={() => setHover(false)} > -

{person}'s score: {score}

+

{person} 的分数:{score}

); @@ -1015,7 +1019,7 @@ h1 {
-Switching between Taylor and Sarah does not preserve the state. This is because **you gave them different `key`s:** +在 Taylor 和 Sarah 之间切换不会使 state 被保留下来。因为 **你给他们赋了不同的 `key`:** ```js {isPlayerA ? ( @@ -1025,15 +1029,15 @@ Switching between Taylor and Sarah does not preserve the state. This is because )} ``` -Specifying a `key` tells React to use the `key` itself as part of the position, instead of their order within the parent. This is why, even though you render them in the same place in JSX, from React's perspective, these are two different counters. As a result, they will never share state. Every time a counter appears on the screen, its state is created. Every time it is removed, its state is destroyed. Toggling between them resets their state over and over. +指定一个 `key` 能够让 React 将 `key` 本身而非它们在父组件中的顺序作为位置的一部分。这就是为什么尽管你用 JSX 将组件渲染在相同位置,但在 React 看来它们是两个不同的计数器。因此它们永远都不会共享 state。每当一个计数器出现在屏幕上时,它的 state 会被创建出来。每当它被移除时,它的 state 就会被销毁。在它们之间切换会一次又一次地使它们的 state 重置。 -> Remember that keys are not globally unique. They only specify the position *within the parent*. +> 请记住 key 不是全局唯一的。它们只能指定 **父组件内部** 的顺序。 -### Resetting a form with a key {/*resetting-a-form-with-a-key*/} +### 使用 key 重置表单 {/*resetting-a-form-with-a-key*/} -Resetting state with a key is particularly useful when dealing with forms. +使用 key 来重置 state 在处理表单时特别有用。 -In this chat app, the `` component contains the text input state: +在这个聊天应用中, `` 组件包含文本输入 state: @@ -1096,11 +1100,11 @@ export default function Chat({ contact }) {