From 0061c5fe28f7fc68528984111b2b445273249ecb Mon Sep 17 00:00:00 2001 From: iamchenxin Date: Sun, 13 Mar 2016 04:24:00 +0000 Subject: [PATCH] [DOCS] Update zh-docs to v15-rc.1 (with #3240c09) --- docs/04-multiple-components.zh-CN.md | 22 +++++----- docs/05-reusable-components.zh-CN.md | 2 +- docs/06-transferring-props.zh-CN.md | 2 +- docs/07-forms.zh-CN.md | 47 ++++++++++++-------- docs/09-tooling-integration.zh-CN.md | 2 +- docs/10-addons.zh-CN.md | 4 +- docs/10.2-form-input-binding-sugar.zh-CN.md | 2 +- docs/12-context.zh-CN.md | 34 ++++++++++++++- docs/getting-started.zh-CN.md | 12 +++++- docs/ref-04-tags-and-attributes.zh-CN.md | 48 ++++++++++++--------- docs/ref-05-events.zh-CN.md | 41 +++++++++++++++++- 11 files changed, 156 insertions(+), 60 deletions(-) diff --git a/docs/04-multiple-components.zh-CN.md b/docs/04-multiple-components.zh-CN.md index 55eeb88b..309d44eb 100644 --- a/docs/04-multiple-components.zh-CN.md +++ b/docs/04-multiple-components.zh-CN.md @@ -14,49 +14,49 @@ next: reusable-components-zh-CN.html ## 组合实例 -一起来使用 Facebook Graph API 开发显示个人图片和用户名的简单 Avatar 组件吧。 +让我们用 Facebook Graph API 来开发一个显示 Facebook 页面图片和用户名的简单 Avatar 组件吧。 ```javascript var Avatar = React.createClass({ render: function() { return (
- - + +
); } }); -var ProfilePic = React.createClass({ +var PagePic = React.createClass({ render: function() { return ( - + ); } }); -var ProfileLink = React.createClass({ +var PageLink = React.createClass({ render: function() { return ( - - {this.props.username} + + {this.props.pagename} ); } }); ReactDOM.render( - , + , document.getElementById('example') ); ``` ## 从属关系 -上面例子中，`Avatar` 拥有 `ProfilePic` 和 `ProfileLink` 的实例。`拥有者` 就是给其它组件设置 `props` 的那个组件。更正式地说，如果组件 `Y` 在 `render()` 方法是创建了组件 `X`，那么 `Y` 就拥有 `X`。上面讲过，组件不能修改自身的 `props` - 它们总是与它们拥有者设置的保持一致。这是保持用户界面一致性的基本不变量。 +上面例子中，`Avatar` 拥有 `PagePic` 和 `PageLink` 的实例。`拥有者` 就是给其它组件设置 `props` 的那个组件。更正式地说，如果组件 `Y` 在 `render()` 方法是创建了组件 `X`，那么 `Y` 就拥有 `X`。上面讲过，组件不能修改自身的 `props` - 它们总是与它们拥有者设置的保持一致。这是保持用户界面一致性的基本不变量。 -把从属关系与父子关系加以区别至关重要。从属关系是 React 特有的，而父子关系简单来讲就是DOM 里的标签的关系。在上一个例子中，`Avatar` 拥有 `div`、`ProfilePic` 和 `ProfileLink` 实例，`div` 是 `ProfilePic` 和 `ProfileLink` 实例的**父级**（但不是拥有者）。 +把从属关系与父子关系加以区别至关重要。从属关系是 React 特有的，而父子关系简单来讲就是DOM 里的标签的关系。在上一个例子中，`Avatar` 拥有 `div`、`PagePic` 和 `PageLink` 实例，`div` 是 `PagePic` 和 `PageLink` 实例的**父级**（但不是拥有者）。 ## 子级 diff --git a/docs/05-reusable-components.zh-CN.md b/docs/05-reusable-components.zh-CN.md index a03b95d4..479466b4 100644 --- a/docs/05-reusable-components.zh-CN.md +++ b/docs/05-reusable-components.zh-CN.md @@ -254,4 +254,4 @@ ReactDOM.render(, mountNode); > > 因为无状态函数没有备份实例，你不能附加一个引用到一个无状态函数组件。 通常这不是问题，因为无状态函数不提供一个命令式的API。没有命令式的API，你就没有任何需要实例来做的事。然而，如果用户想查找无状态函数组件的DOM节点，他们必须把这个组件包装在一个有状态组件里（比如，ES6 类组件） 并且连接一个引用到有状态的包装组件。 -在理想世界里，你的大多数组件都应该是无状态函数式的，因为这些无状态组件可以在React核心里经过一个快速的代码路径。 如果可能，这是推荐的模式。 +在理想世界里，你的大多数组件都应该是无状态函数，因为将来我们可能会用避免不必要的检查和内存分配的方式来对这些组件进行优化。 如果可能，这是推荐的模式。 diff --git a/docs/06-transferring-props.zh-CN.md b/docs/06-transferring-props.zh-CN.md index 9330f58e..6bf89aa2 100644 --- a/docs/06-transferring-props.zh-CN.md +++ b/docs/06-transferring-props.zh-CN.md @@ -96,7 +96,7 @@ function FancyCheckbox(props) { ## 使用和传递同一个 Prop -如果组件需要使用一个属性又要往下传递，可以直接使用 `checked={checked}` 再传一次。这样做比传整个 `this.props` 对象要好，因为更利于重构和语法检查。 +如果组件需要使用一个属性又要往下传递，可以直接使用 `checked={checked}` 再传一次。这样做比传整个 `props` 对象要好，因为更利于重构和语法检查。 ```javascript function FancyCheckbox(props) { diff --git a/docs/07-forms.zh-CN.md b/docs/07-forms.zh-CN.md index 4df7250f..bda03b7b 100644 --- a/docs/07-forms.zh-CN.md +++ b/docs/07-forms.zh-CN.md @@ -30,11 +30,11 @@ next: working-with-the-browser-zh-CN.html > 注意: > -> 对于 `` and ` ``` -对 HTML 而言，让开发者设置多行的值很容易。但是，React 是 JavaScript，没有字符限制，可以使用 `\n` 实现换行。简言之，React 已经有 `value`、`defaultValue` 属性，`` 组件的子节点扮演什么角色就有点模棱两可了。基于此， 设置 `` 组件的子节点扮演什么角色就有点模棱两可了。基于此， 设置 `