docs(cn): translate content/docs/components-and-props.md into Chinese #79

QC-L · 2019-02-07T04:03:35Z

Review this PR!

hijiangtao

有些地方语意不对

content/docs/components-and-props.md

netlify · 2019-02-14T13:38:25Z

Deploy preview for cn-reactjs ready!

Built with commit 3a9c7c8

https://deploy-preview-79--cn-reactjs.netlify.com

content/docs/components-and-props.md

dear-lizhihua · 2019-02-16T10:03:14Z

content/docs/components-and-props.md


 ```js
 function Welcome(props) {
  return <h1>Hello, {props.name}</h1>;
 }
 ```

-This function is a valid React component because it accepts a single "props" (which stands for properties) object argument with data and returns a React element. We call such components "function components" because they are literally JavaScript functions.
+该函数是一个有效的 React 组件，因为它接受唯一带有数据的 “props”（代表属性）对象与并返回一个 React 元素。这类组件被称为“函数组件”，因为它本质上就是 JavaScript 函数。


函数参数是统一用接收还是接受？我觉得接收好一些。

代表属性 => 是 properties 缩写，代表属性。
properties 翻译出来比较好

这类组件被称为“函数组件”
本段小标题是"函数式组件"，我觉得用函数组件比较好，和 Vue 的 functional component 区分。

我觉得没必要区分，函数式组件就是 React 先提出来的

content/docs/components-and-props.md

dear-lizhihua · 2019-02-16T10:06:11Z

content/docs/components-and-props.md


-## Rendering a Component {#rendering-a-component}
+## 组件渲染 {#rendering-a-component}


组件渲染 => 渲染一个组件

我觉得渲染一个组件太啰嗦了，渲染组件吧

content/docs/components-and-props.md

dear-lizhihua · 2019-02-16T10:56:53Z

content/docs/components-and-props.md

@@ -198,7 +198,7 @@ function Comment(props) {
 }
 ```

-Next, we will extract a `UserInfo` component that renders an `Avatar` next to the user's name:
+接下来，我们将提取 `UserInfo` 组件，该组件在用户名旁渲染 `Avatar` 组件：


用户名旁 => 用户名称旁边

感觉有点长

content/docs/components-and-props.md

dear-lizhihua · 2019-02-16T11:13:33Z

content/docs/components-and-props.md


-Of course, application UIs are dynamic and change over time. In the [next section](/docs/state-and-lifecycle.html), we will introduce a new concept of "state". State allows React components to change their output over time in response to user actions, network responses, and anything else, without violating this rule.
+当然，应用程序的 UI 是动态的，并会伴随着时间的推移而变化。在[下一章节](/docs/state-and-lifecycle.html)中，我们将介绍一种新的概念，称之为 “state”。State 可以在不违反上述规则的情况下，允许 React 组件随用户操作、网络响应或者其他变化而动态更改输出内容。。


State 小写
这句多了个句号

State 在作为句首时不应该大写嘛？

中文不需要大写

dear-lizhihua · 2019-02-26T14:11:48Z

content/docs/components-and-props.md


-## Function and Class Components {#function-and-class-components}
+## 函数式组件与 class 组件 {#function-and-class-components}


这里感觉有点画蛇添足，没必要翻译成函数式组件，因为是在强调函数定义和类定义两种。
如果前后文有 side effect，也用了 functional，那种情况要翻译成函数式，强调的是函数式编程。

区分函数组件与 class 组件

dear-lizhihua · 2019-02-26T14:12:21Z

content/docs/components-and-props.md


 ```js
 function Welcome(props) {
  return <h1>Hello, {props.name}</h1>;
 }
 ```

-This function is a valid React component because it accepts a single "props" (which stands for properties) object argument with data and returns a React element. We call such components "function components" because they are literally JavaScript functions.
+该函数是一个有效的 React 组件，因为它接收唯一带有数据的 “props”（代表属性）对象与并返回一个 React 元素。这类组件被称为“函数式组件”，因为它本质上就是 JavaScript 函数。


这里的函数式，同上

single 应该不是强调唯一，这里的 single 意思是函数接收单个参数，翻译成“一个”就行

dear-lizhihua · 2019-02-26T14:13:33Z

content/docs/components-and-props.md


-Classes have some additional features that we will discuss in the [next sections](/docs/state-and-lifecycle.html). Until then, we will use function components for their conciseness.
+我们将在[下一章节](/docs/state-and-lifecycle.html)中讨论关于 class 的额外特性。在那之前，为了保持示例简单明了，将使用函数式组件。


这里的函数式，同上

dear-lizhihua · 2019-02-27T01:58:33Z

content/docs/components-and-props.md

 >
->To learn more about the reasoning behind this convention, please read [JSX In Depth](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized).


JSX In Depth => 深入 JSX

dear-lizhihua · 2019-02-27T02:00:43Z

content/docs/components-and-props.md


-Of course, application UIs are dynamic and change over time. In the [next section](/docs/state-and-lifecycle.html), we will introduce a new concept of "state". State allows React components to change their output over time in response to user actions, network responses, and anything else, without violating this rule.
+当然，应用程序的 UI 是动态的，并会伴随着时间的推移而变化。在[下一章节](/docs/state-and-lifecycle.html)中，我们将介绍一种新的概念，称之为 “state”。State 可以在不违反上述规则的情况下，允许 React 组件随用户操作、网络响应或者其他变化而动态更改输出内容。。


中文不需要大写

netlify · 2019-02-27T02:39:45Z

Deploy preview for zh-hans-reactjs ready!

Built with commit 3a9c7c8

https://deploy-preview-79--zh-hans-reactjs.netlify.com

…reactjs#79)

docs(cn): translate content/docs/components-and-props.md into Chinese

b0eb484

QC-L requested review from hijiangtao and dear-lizhihua February 7, 2019 04:03

hijiangtao reviewed Feb 7, 2019

View reviewed changes

QC-L added 2 commits February 11, 2019 11:46

Merge branch 'master' into translate-components-and-props

063834d

fix: translate error

e0c0c06

jothy1023 reviewed Feb 11, 2019

View reviewed changes

content/docs/components-and-props.md Outdated Show resolved Hide resolved

jothy1023 reviewed Feb 11, 2019

View reviewed changes

content/docs/components-and-props.md Outdated Show resolved Hide resolved

fix: translate error

a67226b

QC-L added the Pending Re-Review 已修改，待审校阶段 label Feb 12, 2019

QC-L mentioned this pull request Feb 14, 2019

OLD CLAIMS #4

Closed

Merge branch 'master' into translate-components-and-props

63c45dd

hijiangtao previously approved these changes Feb 14, 2019

View reviewed changes

hijiangtao mentioned this pull request Feb 15, 2019

[READ ONLY] Translation Check Sheet #98

Closed

dear-lizhihua suggested changes Feb 16, 2019

View reviewed changes

fix: change translate

983935d

QC-L dismissed hijiangtao’s stale review via 983935d February 19, 2019 02:21

hijiangtao previously approved these changes Feb 24, 2019

View reviewed changes

hijiangtao requested review from jothy1023 and dear-lizhihua February 24, 2019 03:18

QC-L requested a review from sang4lv February 24, 2019 15:31

dear-lizhihua reviewed Feb 27, 2019

View reviewed changes

dear-lizhihua previously approved these changes Feb 27, 2019

View reviewed changes

Update components-and-props.md

3a9c7c8

QC-L dismissed stale reviews from dear-lizhihua and hijiangtao via 3a9c7c8 February 27, 2019 02:33

dear-lizhihua self-requested a review February 27, 2019 02:37

dear-lizhihua approved these changes Feb 27, 2019

View reviewed changes

hijiangtao approved these changes Feb 27, 2019

View reviewed changes

hijiangtao merged commit dab1651 into reactjs:master Feb 27, 2019

discountry deleted the translate-components-and-props branch May 2, 2019 20:43

OhIAmFine pushed a commit to OhIAmFine/zh-hans.reactjs.org that referenced this pull request May 6, 2019

docs(cn): translate content/docs/components-and-props.md into Chinese (…

ecce953

…reactjs#79)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs(cn): translate content/docs/components-and-props.md into Chinese #79

docs(cn): translate content/docs/components-and-props.md into Chinese #79

QC-L commented Feb 7, 2019

hijiangtao left a comment

netlify bot commented Feb 14, 2019 •

edited

dear-lizhihua Feb 16, 2019

QC-L Feb 19, 2019

dear-lizhihua Feb 16, 2019

QC-L Feb 19, 2019

dear-lizhihua Feb 16, 2019

QC-L Feb 19, 2019

dear-lizhihua Feb 16, 2019

QC-L Feb 19, 2019

dear-lizhihua Feb 27, 2019

dear-lizhihua Feb 26, 2019

QC-L Feb 27, 2019

dear-lizhihua Feb 26, 2019

dear-lizhihua Feb 26, 2019

dear-lizhihua Feb 26, 2019

dear-lizhihua Feb 27, 2019

dear-lizhihua Feb 27, 2019

netlify bot commented Feb 27, 2019


		## Rendering a Component {#rendering-a-component}
		## 组件渲染 {#rendering-a-component}


		Of course, application UIs are dynamic and change over time. In the [next section](/docs/state-and-lifecycle.html), we will introduce a new concept of "state". State allows React components to change their output over time in response to user actions, network responses, and anything else, without violating this rule.
		当然，应用程序的 UI 是动态的，并会伴随着时间的推移而变化。在[下一章节](/docs/state-and-lifecycle.html)中，我们将介绍一种新的概念，称之为 “state”。State 可以在不违反上述规则的情况下，允许 React 组件随用户操作、网络响应或者其他变化而动态更改输出内容。。


		## Function and Class Components {#function-and-class-components}
		## 函数式组件与 class 组件 {#function-and-class-components}


		Classes have some additional features that we will discuss in the [next sections](/docs/state-and-lifecycle.html). Until then, we will use function components for their conciseness.
		我们将在[下一章节](/docs/state-and-lifecycle.html)中讨论关于 class 的额外特性。在那之前，为了保持示例简单明了，将使用函数式组件。

		>
		>To learn more about the reasoning behind this convention, please read [JSX In Depth](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized).

docs(cn): translate content/docs/components-and-props.md into Chinese #79

docs(cn): translate content/docs/components-and-props.md into Chinese #79

Conversation

QC-L commented Feb 7, 2019

hijiangtao left a comment

Choose a reason for hiding this comment

netlify bot commented Feb 14, 2019 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

netlify bot commented Feb 27, 2019

netlify bot commented Feb 14, 2019 •

edited