[docs] Update zh-CN docs
Update 09-tooling-integration.zh-CN.md 10-addons.zh-CN.md 10.1-animation.zh-CN.md
iamchenxin committed
Sep 25, 2015 at 06:55 UTC
6094739757362c9a7840c25defb52479404e4b67
3 files changed
+351
docs/docs/09-tooling-integration.zh-CN.md
new
+74
@@ -0,0 +1,74 @@
1
+---
2
+id: tooling-integration-zh-CN
3
+title: 工具集成
4
+permalink: tooling-integration-zh-CN.html
5
+prev: more-about-refs-zh-CN.html
6
+next: addons-zh-CN.html
7
+---
8
+
9
+每个项目使用一个不同的系统来建立和部署JavaScript.我们努力使React尽可能环境无关。
10
+
11
+## React
12
+
13
+### CDN-hosted React
14
+
15
+我们提供了CDN-hosted版本的React[在我们的下载页面](/react/downloads.html).这些预构建的文件使用UMD模块格式。将他们放进一个简单的`<script>` 标签将会注入一个`React` 全局变量到你的环境里。这也同样在CommonJS 和 AMD 环境里开箱即用。
16
+
17
+
18
+### 使用 master
19
+
20
+我们[在我们的 GitHub repository](https://github.com/facebook/react)有从`master`构建的说明。我们在`build/modules` 下构建了一个CommonJS模块的树，你可以把它放到任何支持CommonJS的环境或者打包工具里。
21
+
22
+## JSX
23
+
24
+### 浏览器中的JSX转化
25
+
26
+如果你喜欢使用JSX，Babel提供了一个被称为browser.js的[开发用的浏览器中的 ES6 和 JSX 转换器](http://babeljs.io/docs/usage/browser/) ，它可以从`babel-core` npm release 或者[CDNJS](http://cdnjs.com/libraries/babel-core) 中 include。Include `<script type="text/babel">` 标记来使用 JSX 转换器.
27
+
28
+> 注意:
29
+>
30
+> 浏览器中的JSX转换器相当大并且导致额外的本可避免的客户端计算。不要在生产环境中使用 - 见下一节。
31
+
32
+
33
+### 投入生产: 预编译 JSX
34
+
35
+如果你有[npm](https://www.npmjs.com/)，你可以运行 `npm install -g babel`. Babel 对React v0.12 和 v0.13 有内建的支持。 标签被自动转化为它们的等价物`React.createElement(...)`, `displayName` 被自动推断并添加到所有的React.createClass 调用。
36
+
37
+这个工具会把使用JSX语法的文件转化为简单的可直接在浏览器运行的JavaScript文件。它同样将为你监视目录并自动转化文件当他们变动时；例如：`babel --watch src/ --out-dir lib/`.
38
+
39
+默认模式下带有`.js`后缀的JSX文件被转化。运行 `babel --help` 获取更多关于如何使用 Babel 的信息。
40
+
41
+输出的例子：
42
+
43
+```
44
+$ cat test.jsx
45
+var HelloMessage = React.createClass({
46
+ render: function() {
47
+ return <div>Hello {this.props.name}</div>;
48
+ }
49
+});
50
+
51
+React.render(<HelloMessage name="John" />, mountNode);
52
+$ babel test.jsx
53
+"use strict";
54
+
55
+var HelloMessage = React.createClass({
56
+ displayName: "HelloMessage",
57
+
58
+ render: function render() {
59
+ return React.createElement(
60
+ "div",
61
+ null,
62
+ "Hello ",
63
+ this.props.name
64
+ );
65
+ }
66
+});
67
+
68
+React.render(React.createElement(HelloMessage, { name: "John" }), mountNode);
69
+```
70
+
71
+
72
+### 有帮助的开源项目
73
+
74
+开源社区已经创建了一些集成JSX到数个编辑器和构建系统的工具。参见[JSX integrations](https://github.com/facebook/react/wiki/Complementary-Tools#jsx-integrations) 查看全部列表。
docs/docs/10-addons.zh-CN.md
new
+25
@@ -0,0 +1,25 @@
1
+---
2
+id: addons-zh-CN
3
+title: 插件
4
+permalink: addons-zh-CN.html
5
+prev: tooling-integration-zh-CN.html
6
+next: animation-zh-CN.html
7
+---
8
+
9
+`React.addons` 是我们放置一些用来构建React apps的有用的工具的地方。 **这些应该被认为是实验性的** 但是最终批量进入核心代码或者一个有用的工具库中:
10
+
11
+- [`TransitionGroup` 和 `CSSTransitionGroup`](animation.html), 用来处理通常不能简单实现的动画和转换，比如在组件移除之前。
12
+- [`LinkedStateMixin`](two-way-binding-helpers.html), 简化用户的表单输入数据与组件状态的协调。
13
+- [`cloneWithProps`](clone-with-props.html), 创建React组件的浅拷贝并改变它们的props。
14
+- [`createFragment`](create-fragment.html), 创建一组外键的子级。
15
+- [`update`](update.html), 一个使不可变数据在JavaScript里更易处理的辅助函数。
16
+- [`PureRenderMixin`](pure-render-mixin.html), 一个特定情况下的性能优化器。
17
+
18
+下面的插件只存在开发版(未压缩)React中：
19
+
20
+- [`TestUtils`](test-utils.html), 用于写测试用例的简单的辅助工具（仅存在于未压缩版本）。
21
+- [`Perf`](perf.html), 用于测量性能并给你提示哪里可以优化。
22
+
23
+要获取插件，使用 `react-with-addons.js` (和它的压缩副本）而不是通常的 `react.js`。
24
+
25
+当从npm使用react包时，简单的用`require('react/addons')` 代替 `require('react')` 来获取带有所有插件的React。
docs/docs/10.1-animation.zh-CN.md
new
+252
@@ -0,0 +1,252 @@
1
+---
2
+id: animation-zh-CN
3
+title: 动画
4
+permalink: animation-zh-CN.html
5
+prev: addons-zh-CN.html
6
+next: two-way-binding-helpers-zh-CN.html
7
+---
8
+
9
+React 提供了一个 `ReactTransitionGroup` 插件作为动画的底层API,和一个 `ReactCSSTransitionGroup` 用于轻松实现基础的CSS动画和过渡。
10
+
11
+## 高级 API: `ReactCSSTransitionGroup`
12
+
13
+`ReactCSSTransitionGroup` 基于 `ReactTransitionGroup` 是一个当React组件进入或离开DOM时，执行CSS动画和过渡的简单方法。它的灵感来自于杰出的 [ng-animate](http://www.nganimate.org/) 库。
14
+
15
+### 入门指南
16
+
17
+`ReactCSSTransitionGroup` 是 `ReactTransitions` 的接口。这是一个简单的元素，包裹了所有你感兴趣的动画组件。这里是一个淡入和淡出列表项目的例子。
18
+
19
+```javascript{28-30}
20
+var ReactCSSTransitionGroup = React.addons.CSSTransitionGroup;
21
+
22
+var TodoList = React.createClass({
23
+ getInitialState: function() {
24
+ return {items: ['hello', 'world', 'click', 'me']};
25
+ },
26
+ handleAdd: function() {
27
+ var newItems =
28
+ this.state.items.concat([prompt('Enter some text')]);
29
+ this.setState({items: newItems});
30
+ },
31
+ handleRemove: function(i) {
32
+ var newItems = this.state.items;
33
+ newItems.splice(i, 1);
34
+ this.setState({items: newItems});
35
+ },
36
+ render: function() {
37
+ var items = this.state.items.map(function(item, i) {
38
+ return (
39
+ <div key={item} onClick={this.handleRemove.bind(this, i)}>
40
+ {item}
41
+ </div>
42
+ );
43
+ }.bind(this));
44
+ return (
45
+ <div>
46
+ <button onClick={this.handleAdd}>Add Item</button>
47
+ <ReactCSSTransitionGroup transitionName="example" transitionEnterTimeout={500} transitionLeaveTimeout={300} >
48
+ {items}
49
+ </ReactCSSTransitionGroup>
50
+ </div>
51
+ );
52
+ }
53
+});
54
+```
55
+> 注意:
56
+>
57
+> 你必须为`ReactCSSTransitionGroup`的所有子级提供 [ `key` 属性](/react/docs/multiple-components.html#dynamic-children)，即使只渲染一个项目。这就是React将决定哪一个子级进入，离开，或者停留
58
+
59
+在这个组件，当一个新的项目被添加到 `ReactCSSTransitionGroup` ,他将得到`example-enter` CSS类 并且在下一刻`example-enter-active` CSS类被添加。这是一个基于`transitionName` prop 的约定。
60
+
61
+你可以使用这些类来触发CSS动画和过渡。比如，尝试添加这个CSS和添加一个新的列表项：
62
+
63
+```css
64
+.example-enter {
65
+ opacity: 0.01;
66
+}
67
+
68
+.example-enter.example-enter-active {
69
+ opacity: 1;
70
+ transition: opacity 500ms ease-in;
71
+}
72
+
73
+.example-leave {
74
+ opacity: 1;
75
+}
76
+
77
+.example-leave.example-leave-active {
78
+ opacity: 0.01;
79
+ transition: opacity 300ms ease-in;
80
+}
81
+```
82
+
83
+你会注意到动画持续时间需要被同时在CSS和渲染方法里被指定;这告诉React什么时候从元素中移除动画类，并且 -- 如果它正在离开 -- 何时从DOM移除元素。
84
+
85
+### 让初始化挂载动画
86
+
87
+`ReactCSSTransitionGroup` 提供了可选的prop `transitionAppear`，来为在组件初始挂载添加一个额外的过渡阶段。 通常在初始化挂载时没有过渡阶段因为`transitionAppear` 的默认值为`false`。下面是一个传递`transitionAppear` 为值`true`的例子。
88
+
89
+```javascript{3-5}
90
+ render: function() {
91
+ return (
92
+ <ReactCSSTransitionGroup transitionName="example" transitionAppear={true} transitionAppearTimeout={500}>
93
+ <h1>Fading at Initial Mount</h1>
94
+ </ReactCSSTransitionGroup>
95
+ );
96
+ }
97
+```
98
+
99
+在初始化挂载时 `ReactCSSTransitionGroup` 将获得`example-appear` CSS类 并且`example-appear-active` CSS 类在下一刻被添加。
100
+
101
+```css
102
+.example-appear {
103
+ opacity: 0.01;
104
+ transition: opacity .5s ease-in;
105
+}
106
+
107
+.example-appear.example-appear-active {
108
+ opacity: 1;
109
+}
110
+```
111
+
112
+在初始化挂载，所有的 `ReactCSSTransitionGroup` 子级将会 `appear` 但不 `enter`。然而，所有后来添加到已存在的 `ReactCSSTransitionGroup` 的子级将 `enter` 但不 `appear`。
113
+
114
+> 注意:
115
+>
116
+> prop `transitionAppear` 在版本 `0.13` 被添加到 `ReactCSSTransitionGroup`。为了保持向后兼容，默认值被设置为 `false`。
117
+
118
+### 制定类
119
+
120
+可以为你的每一步过渡使用制定类名字。代理传递一个字符串到transitionName，你可以传递一个含有`enter` 或者`leave` 类名的对象，或者一个含有 `enter`, `enter-active`, `leave-active`, 和 `leave` 类名的对象。只要提供了enter 和 leave 的类，enter-active 和 leave-active 类会被决定为后缀'-active' 到类名的尾部。这里是两个使用制定类的例子：
121
+
122
+```javascript
123
+ ...
124
+ <ReactCSSTransitionGroup
125
+ transitionName={ {
126
+ enter: 'enter',
127
+ enterActive: 'enterActive',
128
+ leave: 'leave',
129
+ leaveActive: 'leaveActive',
130
+ appear: 'appear',
131
+ appearActive: 'appearActive'
132
+ } }>
133
+ {item}
134
+ </ReactCSSTransitionGroup>
135
+
136
+ <ReactCSSTransitionGroup
137
+ transitionName={ {
138
+ enter: 'enter',
139
+ leave: 'leave',
140
+ appear: 'appear'
141
+ } }>
142
+ {item2}
143
+ </ReactCSSTransitionGroup>
144
+ ...
145
+```
146
+
147
+### 动画组必须挂载才工作
148
+
149
+为了使过渡效果应用到子级上，`ReactCSSTransitionGroup`必须已经挂载到了DOM或者 prop `transitionAppear` 必须被设置为 `true`。下面的例子不会工作，因为 `ReactCSSTransitionGroup` 随同新项目被挂载，而不是新项目在它内部被挂载。将这与上面的[入门指南](#入门指南)部分比较一下，看看不同。
150
+
151
+```javascript{12-15}
152
+ render: function() {
153
+ var items = this.state.items.map(function(item, i) {
154
+ return (
155
+ <div key={item} onClick={this.handleRemove.bind(this, i)}>
156
+ <ReactCSSTransitionGroup transitionName="example">
157
+ {item}
158
+ </ReactCSSTransitionGroup>
159
+ </div>
160
+ );
161
+ }, this);
162
+ return (
163
+ <div>
164
+ <button onClick={this.handleAdd}>Add Item</button>
165
+ {items}
166
+ </div>
167
+ );
168
+ }
169
+```
170
+
171
+### 动画一个或者零个项目 Animating One or Zero Items
172
+
173
+在上面的例子中，我们渲染了一系列的项目到`ReactCSSTransitionGroup`里。然而 `ReactCSSTransitionGroup` 的子级同样可以是一个或零个项目。这使它能够动画化单个元素的进入和离开。同样，你可以动画化一个新的元素替换当前元素。例如，我们可以像这样实现一个简单的图片轮播器：
174
+
175
+```javascript{10-12}
176
+var ReactCSSTransitionGroup = React.addons.CSSTransitionGroup;
177
+
178
+var ImageCarousel = React.createClass({
179
+ propTypes: {
180
+ imageSrc: React.PropTypes.string.isRequired
181
+ },
182
+ render: function() {
183
+ return (
184
+ <div>
185
+ <ReactCSSTransitionGroup transitionName="carousel" transitionEnterTimeout={300} transitionLeaveTimeout={300}>
186
+ <img src={this.props.imageSrc} key={this.props.imageSrc} />
187
+ </ReactCSSTransitionGroup>
188
+ </div>
189
+ );
190
+ }
191
+});
192
+```
193
+
194
+### 禁用动画
195
+
196
+如果你想,你可以禁用 `enter` 或者 `leave` 动画。例如，有时你可能想要一个 `enter` 动画，不要 `leave` 动画，但是 `ReactCSSTransitionGroup` 会在移除你的DOM节点之前等待一个动画完成。你可以添加`transitionEnter={false}` 或者 `transitionLeave={false}` props 到 `ReactCSSTransitionGroup` 来禁用这些动画。
197
+
198
+> 注意：
199
+>
200
+> 当使用 `ReactCSSTransitionGroup` 时，没有办法通知你的组件何时过渡效果结束或者在动画时执行任何复杂的逻辑运算。如果你想要更多细粒度的控制，你可以使用底层的 `ReactTransitionGroup` API，它提供了你自定义过渡效果所需要的挂钩。
201
+
202
+## 底层 API: `ReactTransitionGroup`
203
+
204
+`ReactTransitionGroup`是动画的基础。它通过 `React.addons.TransitionGroup` 访问。当子级被声明式的从其中添加或移除（就像上面的例子）时，特殊的生命周期挂钩会在它们上面被调用。
205
+
206
+### `componentWillAppear(callback)`
207
+
208
+对于被初始化挂载到 `TransitionGroup` 的组件，它和 `componentDidMount()` 在相同时间被调用 。它将会阻塞其它动画发生，直到`callback`被调用。它只会在 `TransitionGroup` 初始化渲染时被调用。
209
+
210
+### `componentDidAppear()`
211
+
212
+在 传给`componentWillAppear` 的 `回调` 函数被调用后调用。
213
+
214
+### `componentWillEnter(callback)`
215
+
216
+对于被添加到已存在的 `TransitionGroup` 的组件，它和 `componentDidMount()` 在相同时间被调用 。它将会阻塞其它动画发生，直到`callback`被调用。它不会在 `TransitionGroup` 初始化渲染时被调用。
217
+
218
+### `componentDidEnter()`
219
+
220
+在传给 `componentWillEnter` 的`回调`函数被调用之后调用。
221
+
222
+### `componentWillLeave(callback)`
223
+
224
+在子级从 `ReactTransitionGroup` 中移除时调用。虽然子级被移除了，`ReactTransitionGroup` 将会保持它在DOM中，直到`callback`被调用。
225
+
226
+### `componentDidLeave()`
227
+
228
+在`willLeave` `callback` 被调用的时候调用（与 `componentWillUnmount` 同一时间）。
229
+
230
+### 渲染一个不同的组件
231
+
232
+默认情况下 `ReactTransitionGroup` 渲染为一个 `span`。你可以通过提供一个 `component` prop 来改变这种行为。例如，下面是你将如何渲染一个`<ul>`：
233
+
234
+```javascript{1}
235
+<ReactTransitionGroup component="ul">
236
+ ...
237
+</ReactTransitionGroup>
238
+```
239
+
240
+每一个React能渲染的DOM组件都是可用的。然而，`组件`不需要是一个DOM组件。它可以是任何你想要的React组件；甚至是你自己已经写好的！
241
+
242
+> 注意：
243
+>
244
+> v0.12之前，当使用DOM组件时，`组件` prop 需要是一个对`React.DOM.*`的引用。既然组件简单的被传递到 `React.createElement`，它现在必然是一个字符串。复合组件必须传递工厂函数（factory）。
245
+
246
+任何额外的、用户定义的属性将会成为已渲染的组件的属性。例如，以下是你将如何渲染一个带有css类的 `<ul>`：
247
+
248
+```javascript{1}
249
+<ReactTransitionGroup component="ul" className="animated-list">
250
+ ...
251
+</ReactTransitionGroup>
252
+```