Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(cn): translate content/docs/conditional-rendering.md into Chinese #92

Merged
merged 10 commits into from
Feb 27, 2019
Merged
Changes from 7 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 28 additions & 28 deletions content/docs/conditional-rendering.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ redirect_from:
- "tips/false-in-jsx.html"
---

In React, you can create distinct components that encapsulate behavior you need. Then, you can render only some of them, depending on the state of your application.
React 中,你可以创建一些明确的组件来封装各种你需要的行为。然后,依据应用的不同状态,你可以只渲染对应状态下的部分内容。
Copy link
Member

@QC-L QC-L Feb 26, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
在 React 中,你可以创建一些明确的组件来封装各种你需要的行为。然后,依据应用的不同状态,你可以只渲染对应状态下的部分内容。
在 React 中,你可以创建不同的组件来封装你需要的行为。然后,依据应用的不同状态,你可以只渲染对应状态下的部分内容。


Conditional rendering in React works the same way conditions work in JavaScript. Use JavaScript operators like [`if`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/if...else) or the [conditional operator](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Operators/Conditional_Operator) to create elements representing the current state, and let React update the UI to match them.
React 中的条件渲染和 JavaScript 中的一样,使用 JavaScript 运算符 [`if`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/if...else) 或者 [条件运算符](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Operators/Conditional_Operator) 去创建元素来表现当前的状态,然后让 React 根据它们来更新 UI。
Copy link
Member

@QC-L QC-L Feb 26, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
React 中的条件渲染和 JavaScript 中的一样,使用 JavaScript 运算符 [`if`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/if...else) 或者 [条件运算符](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Operators/Conditional_Operator) 去创建元素来表现当前的状态,然后让 React 根据它们来更新 UI。
React 中的条件渲染和 JavaScript 中的条件运算工作原理一致,使用 JavaScript 运算符 [`if`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/if...else) 或者[条件运算符](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Operators/Conditional_Operator)去创建元素来表现当前的状态,然后让 React 根据它们来更新 UI。

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

链接左右不加空格


Consider these two components:
来看看这两个组件:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
来看看这两个组件:
观察这两个组件:


```js
function UserGreeting(props) {
Expand All @@ -24,7 +24,7 @@ function GuestGreeting(props) {
}
```

We'll create a `Greeting` component that displays either of these components depending on whether a user is logged in:
我们再创建一个 `Greeting` 组件,它会根据用户是否登录来决定显示上面的哪一个组件。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
我们再创建一个 `Greeting` 组件,它会根据用户是否登录来决定显示上面的哪一个组件。
再创建一个 `Greeting` 组件,它会根据用户是否登录来决定显示上面的哪一个组件。


```javascript{3-7,11,12}
function Greeting(props) {
Expand All @@ -42,15 +42,15 @@ ReactDOM.render(
);
```

[**Try it on CodePen**](https://codepen.io/gaearon/pen/ZpVxNq?editors=0011)
[**CodePen 上尝试**](https://codepen.io/gaearon/pen/ZpVxNq?editors=0011)

This example renders a different greeting depending on the value of `isLoggedIn` prop.
这个示例根据 `isLoggedIn` 的值来渲染不同的问候语。

### Element Variables
### 元素变量

You can use variables to store elements. This can help you conditionally render a part of the component while the rest of the output doesn't change.
你可以使用变量来储存元素。 它可以帮助你有条件地渲染组件的一部分,而其他的渲染部分并不会因此而改变。

Consider these two new components representing Logout and Login buttons:
来看看这两个组件,它们分别代表了注销和登录按钮:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
来看看这两个组件,它们分别代表了注销和登录按钮:
观察这两个组件,它们分别代表了注销和登录按钮:


```js
function LoginButton(props) {
Expand All @@ -70,9 +70,9 @@ function LogoutButton(props) {
}
```

In the example below, we will create a [stateful component](/docs/state-and-lifecycle.html#adding-local-state-to-a-class) called `LoginControl`.
在下面的示例中,我们将创建一个名叫 `LoginControl` 的 [有状态的组件](/docs/state-and-lifecycle.html#adding-local-state-to-a-class)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
在下面的示例中,我们将创建一个名叫 `LoginControl` [有状态的组件](/docs/state-and-lifecycle.html#adding-local-state-to-a-class)
在下面的示例中,我们将创建一个名叫 `LoginControl`[有状态的组件](/docs/state-and-lifecycle.html#adding-local-state-to-a-class)


It will render either `<LoginButton />` or `<LogoutButton />` depending on its current state. It will also render a `<Greeting />` from the previous example:
它将根据当前的状态来渲染 `<LoginButton />` 或者 `<LogoutButton />`。它也将渲染上一个示例中的 `<Greeting />`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
它将根据当前的状态来渲染 `<LoginButton />` 或者 `<LogoutButton />`它也将渲染上一个示例中的 `<Greeting />`
它将根据当前的状态来渲染 `<LoginButton />` 或者 `<LogoutButton />`同时它还会渲染上一个示例中的 `<Greeting />`


```javascript{20-25,29,30}
class LoginControl extends React.Component {
Expand Down Expand Up @@ -116,13 +116,13 @@ ReactDOM.render(
);
```

[**Try it on CodePen**](https://codepen.io/gaearon/pen/QKzAgB?editors=0010)
[**CodePen 上尝试**](https://codepen.io/gaearon/pen/QKzAgB?editors=0010)

While declaring a variable and using an `if` statement is a fine way to conditionally render a component, sometimes you might want to use a shorter syntax. There are a few ways to inline conditions in JSX, explained below.
声明一个变量并使用 `if` 语句是条件渲染的一个不错的方式,但有时你可能会想使用更简洁的语法。接下来,我们将介绍几种在 JSX 中内联条件渲染的方法。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
声明一个变量并使用 `if` 语句是条件渲染的一个不错的方式,但有时你可能会想使用更简洁的语法。接下来,我们将介绍几种在 JSX 中内联条件渲染的方法。
声明一个变量并使用 `if` 语句进行条件渲染是不错的方式,但有时你可能会想使用更为简洁的语法。接下来,我们将介绍几种在 JSX 中内联条件渲染的方法。


### Inline If with Logical && Operator
### 与运算符 &&

You may [embed any expressions in JSX](/docs/introducing-jsx.html#embedding-expressions-in-jsx) by wrapping them in curly braces. This includes the JavaScript logical `&&` operator. It can be handy for conditionally including an element:
通过花括号包裹代码,你可以 [在 JSX 中嵌入任何表达式](/docs/introducing-jsx.html#embedding-expressions-in-jsx)。这也包括 JavaScript 中的逻辑与 (&&) 运算符。它可以很方便地进行一个元素的条件渲染。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
通过花括号包裹代码,你可以 [在 JSX 中嵌入任何表达式](/docs/introducing-jsx.html#embedding-expressions-in-jsx)。这也包括 JavaScript 中的逻辑与 (&&) 运算符。它可以很方便地进行一个元素的条件渲染
通过花括号包裹代码,你可以[在 JSX 中嵌入任何表达式](/docs/introducing-jsx.html#embedding-expressions-in-jsx)。这也包括 JavaScript 中的逻辑与 (&&) 运算符。它可以很方便地进行元素的条件渲染


```js{6-10}
function Mailbox(props) {
Expand All @@ -146,17 +146,17 @@ ReactDOM.render(
);
```

[**Try it on CodePen**](https://codepen.io/gaearon/pen/ozJddz?editors=0010)
[**CodePen 上尝试**](https://codepen.io/gaearon/pen/ozJddz?editors=0010)

It works because in JavaScript, `true && expression` always evaluates to `expression`, and `false && expression` always evaluates to `false`.
之所以能这样做,是因为在 JavaScript 中,`true && expression` 总是会返回 `expression`, `false && expression` 总是会返回 `false`

Therefore, if the condition is `true`, the element right after `&&` will appear in the output. If it is `false`, React will ignore and skip it.
因此,如果条件是 `true``&&` 右侧的元素就会被渲染,如果是 `false`React 会忽略并跳过它。

### Inline If-Else with Conditional Operator
### 三目运算符
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

使用xx内联xx 的说法好像有些生硬,可以看看大家有没有什么更好的翻译,单大致应该是这意思。

Suggested change
### 三目运算符
### 使用条件运算符内联 If-Else

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

我觉得这里是不是修改下 条件运算符,
三目的说法好像不是很准确

Copy link
Contributor Author

@pppluto pppluto Feb 27, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

wiki上也确实没有三目运算符这个说法 🤔
条件运算符更好一些? @QC-L @yuqingc


Another method for conditionally rendering elements inline is to use the JavaScript conditional operator [`condition ? true : false`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Operators/Conditional_Operator).
另一种内联条件渲染的方法是使用 JavaScript 中的三目运算符 [`condition ? true : false`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Operators/Conditional_Operator)

In the example below, we use it to conditionally render a small block of text.
在下面这个示例中,我们用它来条件渲染一小段文本

```javascript{5}
render() {
Expand All @@ -169,7 +169,7 @@ render() {
}
```

It can also be used for larger expressions although it is less obvious what's going on:
同样的,它也可以用在较大的表达式中,虽然看起来不是太直观:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
同样的,它也可以用在较大的表达式中,虽然看起来不是太直观
同样的,它还可以用于较为复杂的表达式中,尽管看起来不是很直观


```js{5,7,9}
render() {
Expand All @@ -186,13 +186,13 @@ render() {
}
```

Just like in JavaScript, it is up to you to choose an appropriate style based on what you and your team consider more readable. Also remember that whenever conditions become too complex, it might be a good time to [extract a component](/docs/components-and-props.html#extracting-components).
就像在 JavaScript 中一样,你可以根据你们团队的习惯来选择更易读的代码风格。在这里提醒一下,如果条件变得过于复杂,那你应该考虑考虑 [提取组件](/docs/components-and-props.html#extracting-components) 了。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
就像在 JavaScript 中一样,你可以根据你们团队的习惯来选择更易读的代码风格。在这里提醒一下,如果条件变得过于复杂,那你应该考虑考虑 [提取组件](/docs/components-and-props.html#extracting-components)
就像在 JavaScript 中一样,你可以根据团队的习惯来选择可读性更高的代码风格。需要注意的是,如果条件变得过于复杂,那你应该考虑如何[提取组件](/docs/components-and-props.html#extracting-components)


### Preventing Component from Rendering
### 阻止组件渲染

In rare cases you might want a component to hide itself even though it was rendered by another component. To do this return `null` instead of its render output.
在极少数情况下,你可能希望能隐藏组件,即使它已经被其他组件渲染了。为了达到这个目的,你可以让 `render` 方法返回 `null`,而不是其渲染结果。
Copy link
Member

@QC-L QC-L Feb 26, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
在极少数情况下,你可能希望能隐藏组件,即使它已经被其他组件渲染了。为了达到这个目的,你可以让 `render` 方法返回 `null`而不是其渲染结果
在极少数情况下,你可能希望能隐藏组件,即使它已经被其他组件渲染。若要完成此操作,你可以让 `render` 方法直接返回 `null`而不进行任何渲染


In the example below, the `<WarningBanner />` is rendered depending on the value of the prop called `warn`. If the value of the prop is `false`, then the component does not render:
下面的示例中,`<WarningBanner />` 根据 prop 属性 `warn` 的值来进行条件渲染。如果 `warn` 的值是 `false`,那么组件将不会渲染:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
下面的示例中,`<WarningBanner />` 根据 prop 属性 `warn` 的值来进行条件渲染。如果 `warn` 的值是 `false`那么组件将不会渲染:
下面的示例中,`<WarningBanner />` 会根据 prop 中的 `warn` 的值来进行条件渲染。如果 `warn` 的值是 `false`那么组件则不会渲染:


```javascript{2-4,29}
function WarningBanner(props) {
Expand Down Expand Up @@ -238,6 +238,6 @@ ReactDOM.render(
);
```

[**Try it on CodePen**](https://codepen.io/gaearon/pen/Xjoqwm?editors=0010)
[**CodePen 上尝试**](https://codepen.io/gaearon/pen/Xjoqwm?editors=0010)

Returning `null` from a component's `render` method does not affect the firing of the component's lifecycle methods. For instance `componentDidUpdate` will still be called.
在组件的 `render` 方法中返回 `null` 并不会影响组件的生命周期方法的回调。例如,上面这个示例中,`componentDidUpdate` 依然会被调用。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
在组件的 `render` 方法中返回 `null` 并不会影响组件的生命周期方法的回调。例如,上面这个示例中,`componentDidUpdate` 依然会被调用。
在组件的 `render` 方法中返回 `null` 并不会影响组件的生命周期。例如,上面这个示例中,`componentDidUpdate` 依然会被调用。