Skip to content
Browse files

update zh-docs (v0.14.3+)

  • Loading branch information...
1 parent 4865ddf commit badc15e3c045a59adc3fe1acb76c7c98015e8927 @iamchenxin iamchenxin committed
View
1 .gitignore
@@ -25,3 +25,4 @@ chrome-user-data
*.sublime-workspace
.idea
*.iml
+.vscode
View
32 docs/docs/10.10-shallow-compare.zh-CN.md
@@ -0,0 +1,32 @@
+---
+id: shallow-compare-zh-CN
+title: 浅比较
+permalink: shallow-compare-zh-CN.html
+prev: perf-zh-CN.html
+next: advanced-performance-zh-CN.html
+---
+
+`shallowCompare` 是一个辅助函数 在以ES6类使用React时,完成和 `PureRenderMixin` 相同的功能。
+
+如果你的React组件的绘制函数是 “干净的” (换句话说,它在给定的 props 和 state 下绘制相同的结果),你可以使用这个辅助函数以在某些情况下提升性能。
+
+例如:
+
+```js
+var shallowCompare = require('react-addons-shallow-compare');
+export class SampleComponent extends React.Component {
+ shouldComponentUpdate(nextProps, nextState) {
+ return shallowCompare(this, nextProps, nextState);
+ }
+
+ render() {
+ return <div className={this.props.className}>foo</div>;
+ }
+}
+```
+
+`shallowCompare` 对当前的 `props``nextProps`对象 执行一个浅的相等检查,同样对于 `state``nextState`对象。
+它 通过迭代比较对象的keys 并在 对象的key值不严格相等时返回false 实现此功能.
+
+`shallowCompare` 返回 `true` 如果对 props 或 state的浅比较失败,因此组件应该更新。
+`shallowCompare` 返回 `false` 如果对 props 或 state的浅比较都通过了,因此组件不应该更新。
View
117 docs/docs/10.2-form-input-binding-sugar.zh-CN.md
@@ -0,0 +1,117 @@
+---
+id: two-way-binding-helpers-zh-CN
+title: 双向绑定辅助
+permalink: two-way-binding-helpers-zh-CN.html
+prev: animation-zh-CN.html
+next: test-utils-zh-CN.html
+---
+
+`ReactLink` 是一个用React表达双向绑定的简单方法。
+
+> 注意:
+>
+> 如果你刚学这个框架,注意 `ReactLink` 对大多数应用是不需要的,应该慎重的使用。
+
+在React里,数据单向流动: 从拥有者到子级。这是因为数据只单向流动[the Von Neumann model of computing](https://en.wikipedia.org/wiki/Von_Neumann_architecture)。你可以把它想象为 “单向数据绑定”。
+
+然而,有很多应用需要你去读某些数据并回流他们到你的程序。例如,当开发forms,你会常常想更新一些React `state` 当你收到用户输入的时候。或者也许你想在JavaScript完成布局并相应一些DOM元素大小的变化。
+
+在React里,你可以用监听 "change" 事件来实现它,从你的数据源(通常是DOM)读取并在你的某个组件调用 `setState()` 。明确的"Closing the data flow loop" 致使了更容易理解和维护的程序。更多信息见[our forms documentation](/react/docs/forms.html).
+
+双向绑定 -- 隐含的强迫DOM里的某些值总是和某些React `state` 同步 -- 简洁并支持大量多样的应用。 我们提供了 `ReactLink`:设置如上描述的通用数据回流模式的语法糖,或者 "linking" 某些数据结构到 React `state`.
+
+> 注意:
+>
+> `ReactLink` 只是一层对 `onChange`/`setState()` 模式的薄包装。它没有根本性的改变你的React应用里数据如何流动。
+
+## ReactLink: 之前和之后
+
+这里有一个简单的 不用 `ReactLink` 的 form 例子:
+
+```javascript
+var NoLink = React.createClass({
+ getInitialState: function() {
+ return {message: 'Hello!'};
+ },
+ handleChange: function(event) {
+ this.setState({message: event.target.value});
+ },
+ render: function() {
+ var message = this.state.message;
+ return <input type="text" value={message} onChange={this.handleChange} />;
+ }
+});
+```
+
+这个工作的很好并且数据如何流动很清晰,然而,当有大量的 form fields时,可能会有些冗长。让我们使用 `ReactLink` 来节省我们的输入:
+
+```javascript{4,9}
+var LinkedStateMixin = require('react-addons-linked-state-mixin');
+
+var WithLink = React.createClass({
+ mixins: [LinkedStateMixin],
+ getInitialState: function() {
+ return {message: 'Hello!'};
+ },
+ render: function() {
+ return <input type="text" valueLink={this.linkState('message')} />;
+ }
+});
+```
+
+`LinkedStateMixin` 添加了一个 `linkState()` 方法到你的React组件。`linkState()` 返回一个 `ReactLink` 包含当前React state值的对象和一个改变它的回调函数。
+
+`ReactLink` 对象可以作为props在树中上下传递,所以很容易(显示的)在深层次的组件和高层次的state之间 设置双向绑定。
+
+注意 checkboxes 有一个关于他们 `value` 属性的特殊行为,这个行为是 如果checkbox被选中 值会在表单提交时被发送。 `value` 不会 checkbox 选中或是不选中时更新。对于checkboxes,你应该用`checkedLink` 代替 `valueLink`:
+```
+<input type="checkbox" checkedLink={this.linkState('booleanValue')} />
+```
+
+## 引擎盖下
+
+There are two sides to `ReactLink`: the place where you create the `ReactLink` instance and the place where you use it. To prove how simple `ReactLink` is, let's rewrite each side separately to be more explicit.
+
+### ReactLink Without LinkedStateMixin
+
+```javascript{5-7,9-12}
+var WithoutMixin = React.createClass({
+ getInitialState: function() {
+ return {message: 'Hello!'};
+ },
+ handleChange: function(newValue) {
+ this.setState({message: newValue});
+ },
+ render: function() {
+ var valueLink = {
+ value: this.state.message,
+ requestChange: this.handleChange
+ };
+ return <input type="text" valueLink={valueLink} />;
+ }
+});
+```
+
+As you can see, `ReactLink` objects are very simple objects that just have a `value` and `requestChange` prop. And `LinkedStateMixin` is similarly simple: it just populates those fields with a value from `this.state` and a callback that calls `this.setState()`.
+
+### ReactLink Without valueLink
+
+```javascript
+var LinkedStateMixin = require('react-addons-linked-state-mixin');
+
+var WithoutLink = React.createClass({
+ mixins: [LinkedStateMixin],
+ getInitialState: function() {
+ return {message: 'Hello!'};
+ },
+ render: function() {
+ var valueLink = this.linkState('message');
+ var handleChange = function(e) {
+ valueLink.requestChange(e.target.value);
+ };
+ return <input type="text" value={valueLink.value} onChange={handleChange} />;
+ }
+});
+```
+
+The `valueLink` prop is also quite simple. It simply handles the `onChange` event and calls `this.props.valueLink.requestChange()` and also uses `this.props.valueLink.value` instead of `this.props.value`. That's it!
View
11 docs/docs/10.3-class-name-manipulation.zh-CN.md
@@ -0,0 +1,11 @@
+---
+id: class-name-manipulation-zh-CN
+title: 类名操纵
+permalink: class-name-manipulation-zh-CN.html
+prev: two-way-binding-helpers-zh-CN.html
+next: test-utils-zh-CN.html
+---
+
+> NOTE:
+>
+> 此模块已被弃用; 用 [JedWatson/classnames](https://github.com/JedWatson/classnames) 替代.
View
173 docs/docs/12-context.zh-CN.md
@@ -0,0 +1,173 @@
+---
+id: context-zh-CN
+title: Context
+permalink: context-zh-CN.html
+prev: advanced-performance-zh-CN.html
+---
+
+React最大的优势之一是他很容易从你的React组件里跟踪数据流动。当你看着一个组件,你可以很容易准确看出哪个props被传入,这让你的APP很容易推断。
+
+偶尔,你想通过组件树传递数据,而不在每一级上手工下传prop,React的 "context" 让你做到这点。
+
+> 注意:
+> 
+> Context是一个先进的实验性特性.这个 API 很可能在未来版本变化.
+>
+> 大多数应用将不会需要用到 context. 尤其是如果你刚开始用React,你很可能不会想用 context.使用 context 将会使你的代码很难理解因为它让数据流不清晰.它类似于在你的应用里使用全局变量传递state.
+>
+> **如果你必须使用 context ,保守的使用它**
+>
+> 不论你正在创建一个应用或者是库,试着分离你对 context 的使用到一个小区域,并尽可能避免直接使用 context API,以便在API变动时容易升级.
+
+## 从树里自动传递info
+
+假设你有一个这样的结构:
+
+```javascript
+var Button = React.createClass({
+ render: function() {
+ return (
+ <button style={{'{{'}}background: this.props.color}}>
+ {this.props.children}
+ </button>
+ );
+ }
+});
+
+var Message = React.createClass({
+ render: function() {
+ return (
+ <div>
+ {this.props.text} <Button color={this.props.color}>Delete</Button>
+ </div>
+ );
+ }
+});
+
+var MessageList = React.createClass({
+ render: function() {
+ var color = "purple";
+ var children = this.props.messages.map(function(message) {
+ return <Message text={message.text} color={color} />;
+ });
+ return <div>{children}</div>;
+ }
+});
+```
+
+在这里例子里,我们手工穿透一个 `color` prop 以便于恰当格式化 `Button``Message` 组件.主题是一个很好的例子,当你可能想整个子树都可以访问一部分信息时(比如color). 使用 context 我们可以自动传过这个树:
+
+```javascript{2-4,7,18,25-30,33}
+var Button = React.createClass({
+ contextTypes: {
+ color: React.PropTypes.string
+ },
+ render: function() {
+ return (
+ <button style={{'{{'}}background: this.context.color}}>
+ {this.props.children}
+ </button>
+ );
+ }
+});
+
+var Message = React.createClass({
+ render: function() {
+ return (
+ <div>
+ {this.props.text} <Button>Delete</Button>
+ </div>
+ );
+ }
+});
+
+var MessageList = React.createClass({
+ childContextTypes: {
+ color: React.PropTypes.string
+ },
+ getChildContext: function() {
+ return {color: "purple"};
+ },
+ render: function() {
+ var children = this.props.messages.map(function(message) {
+ return <Message text={message.text} />;
+ });
+ return <div>{children}</div>;
+ }
+});
+```
+
+通过添加 `childContextTypes``getChildContext``MessageList` ( context 提供),React下传信息到子树中的任何组件(在这个例子中, `Button`可以由定义 `contextTypes`来访问它).
+
+如果 `contextTypes` 没有定义,那么 `this.context` 将是一个空对象.
+
+## 父子耦合
+
+Context 同样可以使你构建这样的 APT:
+
+```javascript
+<Menu>
+ <MenuItem>aubergine</MenuItem>
+ <MenuItem>butternut squash</MenuItem>
+ <MenuItem>clementine</MenuItem>
+</Menu>
+```
+
+通过在 `Menu` 组件下传相关的信息,每个 `MenuItem` 可以与包含他们的 `Menu` 组件沟通.
+
+**在你用这个API构建组件以前,考虑一下是否有清晰的替代方案** 我们 喜欢像这样简单的用数组传递items:
+
+```javascript
+<Menu items={['aubergine', 'butternut squash', 'clementine']} />
+```
+
+记住你同样可以在props里传递整个React组件,如果你想.
+
+## 在生命周期方法里引用 context
+
+如果 `contextTypes` 在一个组件中定义,接下来的生命周期方法会收到一个额外的参数, `context` 对象:
+
+```javascript
+void componentWillReceiveProps(
+ object nextProps, object nextContext
+)
+
+boolean shouldComponentUpdate(
+ object nextProps, object nextState, object nextContext
+)
+
+void componentWillUpdate(
+ object nextProps, object nextState, object nextContext
+)
+
+void componentDidUpdate(
+ object prevProps, object prevState, object prevContext
+)
+```
+
+## 在无状态函数组件里引用 context
+
+无状态函数同样能够引用 `context` 如果 `contextTypes` 被定义为函数的属性.下面的代码展示了被写为无状态函数组件的 `Button` 组件.
+
+```javascript
+function Button(props, context) {
+ return (
+ <button style={{'{{'}}background: context.color}}>
+ {props.children}
+ </button>
+ );
+}
+Button.contextTypes = {color: React.PropTypes.string};
+```
+
+## 什么时候不用 context
+
+正像全局变量是在写清晰代码时最好要避免的,你应该在大多数情况下避免使用context. 特别是,在用它来"节省输入"和代替显示传入props时要三思.
+
+context最好的使用场景是隐式的传入登录的用户,当前的语言,或者主题信息.要不然所有这些可能就是全局变量,但是context让你限定他们到一个单独的React树里.
+
+不要用context在组件里传递你的模型数据.通过树显示的传递你的数据更容易理解.使用context使你的组件更耦合和不可复用,因为 依赖于他们在哪里渲染,他们会表现不同的行为.
+
+## 已知的限制
+
+如果一个由组件提供的context值变动,使用那个值的子级不会更新,如果一个直接的父级从 `shouldComponentUpdate` 返回 `false` .详见 issue [#2517](https://github.com/facebook/react/issues/2517) .
View
29 docs/docs/conferences.zh-CN.md
@@ -0,0 +1,29 @@
+---
+id: conferences-zh-CN
+title: 会议
+permalink: conferences-zh-CN.html
+prev: thinking-in-react-zh-CN.html
+next: videos-zh-CN.html
+---
+
+### React.js Conf 2015
+一月 28 & 29
+
+[Website](http://conf.reactjs.com/) - [Schedule](http://conf.reactjs.com/schedule.html) - [Videos](https://www.youtube-nocookie.com/playlist?list=PLb0IAmt7-GS1cbw4qonlQztYV1TAW0sCr)
+
+<iframe width="650" height="315" src="//www.youtube-nocookie.com/embed/KVZ-P-ZI6W4?list=PLb0IAmt7-GS1cbw4qonlQztYV1TAW0sCr" frameborder="0" allowfullscreen></iframe>
+
+### ReactEurope 2015
+七月 2 & 3
+
+[Website](http://www.react-europe.org/) - [Schedule](http://www.react-europe.org/#schedule)
+
+### Reactive 2015
+十一月 2-4
+
+[Website](https://reactive2015.com/) - [Schedule](https://reactive2015.com/schedule_speakers.html#schedule)
+
+### ReactEurope 2016
+六月 2 & 3
+
+[Website](http://www.react-europe.org/) - [Schedule](http://www.react-europe.org/#schedule)
View
44 docs/docs/getting-started.zh-CN.md
@@ -13,7 +13,6 @@ redirect_from: "docs/index-zh-CN.html"
* **[React JSFiddle](https://jsfiddle.net/reactjs/69z2wepo/)**
* [React JSFiddle without JSX](https://jsfiddle.net/reactjs/5vjqabv3/)
-
## 通过 npm 使用 React
我们建议在 React 中使用 CommonJS 模块系统,比如 [browserify](http://browserify.org/) 或 [webpack](https://webpack.github.io/)。使用 [`react`](https://www.npmjs.com/package/react) 和 [`react-dom`](https://www.npmjs.com/package/react-dom) npm 包.
@@ -29,23 +28,32 @@ ReactDOM.render(
);
```
+要用 browserify 安装 React DOM 和构建你的包。
+
+```sh
+$ npm install --save react react-dom babelify babel-preset-react
+$ browserify -t [ babelify --presets [ react ] ] main.js -o bundle.js
+```
-在安装 browserify 之后安装 React DOM 和构建你的应用包。
+要用 webpack 安装 React DOM 和构建你的包:
```sh
-$ npm install --save react react-dom
-$ browserify -t babelify main.js -o bundle.js
+$ npm install --save react react-dom babel-preset-react
+$ webpack
```
-## 不使用 npm 快速开始
+> 注意:
+>
+> 如果你正在使用 ES2015, 你将要使用 `babel-preset-es2015` 包.
+
+## 不用 npm 的快速开始
-If you're not ready to use npm yet, you can download the starter kit which includes prebuilt copies of React and React DOM.
-如果你没有做好使用 npm 的准备,你可以下载包含了 React 和 ReactDOM 预生成包的入门教程包。
+如果你现在还没准备要使用npm,你可以下载这个已经包含了预构建的 React 和 React DOM 拷贝的入门套件.
<div class="buttons-unit downloads">
<a href="/react/downloads/react-{{site.react_version}}.zip" class="button">
- 下载入门教程 {{site.react_version}}
+ 下载入门套件 {{site.react_version}}
</a>
</div>
@@ -96,21 +104,24 @@ ReactDOM.render(
### 离线转换
-先安装[Babel](http://babeljs.io/)命令行工具(依赖 [npm](https://www.npmjs.com/)):
+先安装[Babel](http://babeljs.io/)命令行工具(需要 [npm](https://www.npmjs.com/)):
```
-npm install --global babel
+npm install --global babel-cli
+npm install babel-preset-react
```
然后把你的 `src/helloworld.js` 文件转成标准的 JavaScript:
```
-babel src --watch --out-dir build
-
+babel --presets react src --watch --out-dir build
```
-`build/helloworld.js` 会在你对文件进行修改时自动生成。 阅读 [Babel CLI 文档](http://babeljs.io/docs/usage/cli/) 了解高级用法。
+> 注意:
+>
+> 如果你正在使用 ES2015, 你将需要使用 `babel-preset-es2015` 包.
+`build/helloworld.js` 会在你对文件进行修改时自动生成。 阅读 [Babel CLI 文档](http://babeljs.io/docs/usage/cli/) 了解高级用法。
```javascript{2}
ReactDOM.render(
@@ -121,14 +132,15 @@ ReactDOM.render(
对照下面更新你的 HTML 代码
-```html{7,11}
+```html{8,12}
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" />
<title>Hello React!</title>
<script src="build/react.js"></script>
- <!-- 不需要 Babel! -->
+ <script src="build/react-dom.js"></script>
+ <!-- 不需要 Babel! -->
</head>
<body>
<div id="example"></div>
@@ -137,8 +149,6 @@ ReactDOM.render(
</html>
```
-
-
## 下一步
去看看[入门教程](/react/docs/tutorial.html) 和入门教程包 `examples` 目录下的其它例子学习更多。
View
136 docs/docs/ref-01-top-level-api.zh-CN.md
@@ -69,123 +69,143 @@ factoryFunction createFactory(
返回一个生成给定类型的 ReactElements 的函数。如同 `React.createElement`,type 参数既可以是一个 html 标签名字符串(例如. “div”,“span”,等等),也可以是一个 `ReactClass`
-
-
-### React.render
+### React.isValidElement
```javascript
-ReactComponent render(
- ReactElement element,
- DOMElement container,
- [function callback]
-)
+boolean isValidElement(* object)
```
-渲染一个 ReactElement 到 DOM 里提供的 `容器(container)`中,并返回一个对组件的引用
+验证对象是否是一个 ReactElement。
-如果 ReactElement 之前被渲染到了 `container` 中,这将对它执行一次更新,并仅变动需要变动的 DOM 来反映最新的 React 组件。
-如果提供了可选的回调函数,则该函数将会在组件渲染或者更新之后被执行。
+### React.DOM
-> 注意:
->
-> `React.render()` 控制你传入的 container 节点的内容。
-> 当初次调用时,任何现存于内的 DOM 元素将被替换。
-> 其后的调用使用 React的 diffing 算法来有效率的更新。
->
-> `React.render()` 不会修改 container 节点(只修改 container 的子级)。
-> 将来,也许能够直接插入一个组件到已经存在的 DOM 节点而不覆盖
-> 现有的子级。
+`React.DOM``React.createElement` 为 DOM 组件提供了便利的包装器。该方式应该只在不使用 JSX 的时使用。例如,`React.DOM.div(null, 'Hello World!')`
-### React.unmountComponentAtNode
+### React.PropTypes
-```javascript
-boolean unmountComponentAtNode(DOMElement container)
-```
+`React.PropTypes` 包含了能与 组件的`propTypes` 对象一起使用的类型,用以验证传入你的组件的 props。更多有关 `propTypes` 的信息,请见 [可重用组件](/react/docs/reusable-components-zh-CN.html)。
-从 DOM 中移除已经挂载的 React 组件,并清除它的事件处理器和 state。如果在 container 中没有组件被挂载,调用此函数将什么都不做。如果组件被卸载返回 `true`,如果没有组件被卸载返回 `false`。
+### React.Children
-### React.renderToString
+`React.Children` 为处理 `this.props.children` 这个不透明的数据结构提供了工具。
+
+#### React.Children.map
```javascript
-string renderToString(ReactElement element)
+array React.Children.map(object children, function fn [, object thisArg])
```
-把 ReactElement 渲染为它原始的 HTML 。这应该仅在服务器端使用。React 将会返回一个 HTML 字符串。你可以用这种方法在服务器端生成 HTML,然后在初始请求下传这些标记,以获得更快的页面加载速度及允许搜索引擎抓取页面(便于 SEO)
+在每一个包含在 `children` 中的直接子级上调用 `fn` ,`fn`中的 `this` 设置为 `thisArg`。如果 `children` 是一个嵌套的对象或者数组,它将被遍历:不会传入容器对象到 `fn` 中。如果 children 是 `null` 或者 `undefined`,则返回 `null` 或者 `undefined` 而不是一个空数组
-如果在一个在已经有了这种服务器预渲染标记的节点上面调用 `React.render()`,React 将会维护该节点,仅绑定事件处理器,让你有一个非常高效的初次加载体验。
+#### React.Children.forEach
+```javascript
+React.Children.forEach(object children, function fn [, object thisArg])
+```
-### React.renderToStaticMarkup
+类似 `React.Children.map()`,但是不返回数组。
+
+#### React.Children.count
```javascript
-string renderToStaticMarkup(ReactElement element)
+number React.Children.count(object children)
```
-类似于 `renderToString` ,除了不创建额外的 DOM 属性,比如 `data-react-id`,这仅在 React 内部使用的属性。如果你想用 React 做一个简单的静态页面生成器,这是很有用的,因为去除额外的属性能够节省很多字节。
-
+返回 `children` 中的组件总数,相等于传递给 `map` 或者 `forEach` 的回调函数应被调用次数。
-### React.isValidElement
+#### React.Children.only
```javascript
-boolean isValidElement(* object)
+object React.Children.only(object children)
```
-验证对象是否是一个 ReactElement。
-
+返回 `children` 中仅有的子级。否则抛出异常。
-### React.findDOMNode
+#### React.Children.toArray
```javascript
-DOMElement findDOMNode(ReactComponent component)
+array React.Children.toArray(object children)
```
-如果这个组件已经被挂载到了 DOM,它返回相应的浏览器原生的 DOM 元素。这个方法对于读取 DOM 的值很有用,比如表单域的值和执行 DOM 的测量。如果 `render` 返回 `null` 或者 `false`, `findDOMNode` 返回 `null`.
+以赋key给每个child的平坦的数组形式,返回不透明的 `children` 数据结构.如果你想操纵你的渲染方法的子级的合集这很有用,尤其如果你想在 `this.props.children` 传下之前渲染或者切割.
-### React.DOM
+## ReactDOM
-`React.DOM` 用 `React.createElement` 为 DOM 组件提供了便利的包装器。该方式应该只在不使用 JSX 的时使用。例如,`React.DOM.div(null, 'Hello World!')`。
+`react-dom` 包提供了 具体的DOM方法,这些方法可以在你的app的顶层作为一个你需要时脱离React模式的安全舱口 被使用.你的大多数组件不需要使用这个模块.
+### ReactDOM.render
-### React.PropTypes
+```javascript
+ReactComponent render(
+ ReactElement element,
+ DOMElement container,
+ [function callback]
+)
+```
-`React.PropTypes` 包含了能与 组件的`propTypes` 对象一起使用的类型,用以验证传入你的组件的 props。更多有关 `propTypes` 的信息,请见 [可重用组件](/react/docs/reusable-components-zh-CN.html)
+渲染一个 ReactElement 到 DOM 里提供的 `容器(container)`中,并返回一个对 组件(或者返回 `null` 对于 [无状态组件](/react/docs/reusable-components.html#stateless-functions)) 的[引用](/react/docs/more-about-refs.html)
+如果 ReactElement 之前被渲染到了 `container` 中,这将对它执行一次更新,并仅变动需要变动的 DOM 来反映最新的 React 组件。
-### React.Children
+如果提供了可选的回调函数,则该函数将会在组件渲染或者更新之后被执行。
-`React.Children` 为处理 `this.props.children` 这个不透明的数据结构提供了工具。
+> 注意:
+>
+> `ReactDOM.render()` 控制你传入的 container 节点的内容。
+> 当初次调用时,任何现存于内的 DOM 元素将被替换。
+> 其后的调用使用 React的 diffing 算法来有效率的更新。
+>
+> `ReactDOM.render()` 不会修改 container 节点(只修改 container 的子级)。
+> 将来,也许能够直接插入一个组件到已经存在的 DOM 节点而不覆盖
+> 现有的子级。
-#### React.Children.map
+
+### ReactDOM.unmountComponentAtNode
```javascript
-object React.Children.map(object children, function fn [, object thisArg])
+boolean unmountComponentAtNode(DOMElement container)
```
-在每一个包含在 `children` 中的直接子级上调用 `fn` ,`fn`中的 `this` 设置为 `thisArg`。如果 `children` 是一个嵌套的对象或者数组,它将被遍历:不会传入容器对象到 `fn` 中。如果 children 是 `null` 或者 `undefined`,则返回 `null` 或者 `undefined` 而不是一个空对象
+从 DOM 中移除已经挂载的 React 组件,并清除它的事件处理器和 state。如果在 container 中没有组件被挂载,调用此函数将什么都不做。如果组件被卸载返回 `true`,如果没有组件被卸载返回 `false`
-#### React.Children.forEach
+
+### ReactDOM.findDOMNode
```javascript
-React.Children.forEach(object children, function fn [, object thisArg])
+DOMElement findDOMNode(ReactComponent component)
```
+如果这个组件已经被挂载到了 DOM,它返回相应的浏览器原生的 DOM 元素。这个方法对于读取 DOM 的值很有用,比如表单域的值和执行 DOM 的测量。**在大多数情况下,你可以连接一个ref到DOM节点上,并避免使用 `findDOMNode`** 如果 `render` 返回 `null` 或者 `false`, `findDOMNode` 返回 `null`.
-类似 `React.Children.map()`,但是不返回对象。
+> 注意:
+>
+> `findDOMNode()` 是一个用来访问底层DOM节点的安全舱口.大多数情况下,使用这个安全舱口是不被鼓励的,因为它穿破了组件的抽象.
+>
+> `findDOMNode()` 只在已挂载的组件上工作(即是,已经被放置到DOM里的组件).如果你尝试在没有被挂载的组件上调用这个方法(比如在 一个没有被创建的组件的`render()`里 调用 `findDOMNode()` )会抛出一个异常.
+>
+> `findDOMNode()` 不能用在无状态组件.
-#### React.Children.count
+## ReactDOMServer
+
+`react-dom/server` 允许你在服务器上渲染你的组件.
+
+### ReactDOMServer.renderToString
```javascript
-number React.Children.count(object children)
+string renderToString(ReactElement element)
```
-返回 `children` 中的组件总数,相等于传递给 `map` 或者 `forEach` 的回调函数应被调用次数
+把 ReactElement 渲染为它原始的 HTML 。这应该仅在服务器端使用。React 将会返回一个 HTML 字符串。你可以用这种方法在服务器端生成 HTML,然后在初始请求下传这些标记,以获得更快的页面加载速度及允许搜索引擎抓取页面(便于 SEO)
-#### React.Children.only
+如果在一个在已经有了这种服务器预渲染标记的节点上面调用 `ReactDOM.render()`,React 将会维护该节点,仅绑定事件处理器,让你有一个非常高效的初次加载体验。
+
+
+### ReactDOMServer.renderToStaticMarkup
```javascript
-object React.Children.only(object children)
+string renderToStaticMarkup(ReactElement element)
```
-返回 `children` 中仅有的子级。否则抛出异常
+类似于 `renderToString` ,除了不创建额外的 DOM 属性,比如 `data-react-id`,这仅在 React 内部使用的属性。如果你想用 React 做一个简单的静态页面生成器,这是很有用的,因为去除额外的属性能够节省很多字节
View
30 docs/docs/ref-02-component-api.zh-CN.md
@@ -8,13 +8,13 @@ next: component-specs-zh-CN.html
## React.Component
-当渲染时,React 组件的实例在 React 内部被创建。这些实例在随后的渲染中被重复使用,并可以在组件方法中通过 `this` 访问。唯一的在 React 之外获取 React 组件实例句柄的方法是保存 `React.render` 的返回值。在其它组件内,你可以使用 [refs](/react/docs/more-about-refs-zh-CN.html) 得到相同的结果。
+当渲染时,React 组件的实例在 React 内部被创建。这些实例在随后的渲染中被重复使用,并可以在组件方法中通过 `this` 访问。唯一的在 React 之外获取 React 组件实例句柄的方法是保存 `ReactDOM.render` 的返回值。在其它组件内,你可以使用 [refs](/react/docs/more-about-refs-zh-CN.html) 得到相同的结果。
### setState
```javascript
-setState(
+void setState(
function|object nextState,
[function callback]
)
@@ -29,7 +29,7 @@ setState(
setState({mykey: 'my new value'});
```
-也可以以 `function(state, props)` 传递一个函数。当你想要把一个在设置任何值之前参考前一次 state+props 的值的原子更新放在队列中 这会有很用。例如,假如我们想在 state 增加一个值
+也可以以 `function(state, props)` 传递一个函数。当你想要把一个在设置任何值之前参考前一次 state+props 的值的原子更新放在队列中 这会有很用。例如,假如我们想在 state 增加一个值:
```javascript
setState(function(previousState, currentProps) {
@@ -53,7 +53,7 @@ setState(function(previousState, currentProps) {
### replaceState
```javascript
-replaceState(
+void replaceState(
object nextState,
[function callback]
)
@@ -69,7 +69,7 @@ replaceState(
### forceUpdate
```javascript
-forceUpdate(
+void forceUpdate(
[function callback]
)
```
@@ -91,7 +91,7 @@ DOMElement getDOMNode()
> Note:
>
-> getDOMNode 被废弃了,已经被 [React.findDOMNode()] 替换(/react/docs/top-level-api-zh-CN.html#react.finddomnode).
+> getDOMNode 被废弃了,已经被 [ReactDOM.findDOMNode()] 替换(/react/docs/top-level-api-zh-CN.html#reactdom.finddomnode).
>
> 这个方法在从 `React.Component` 扩展的 ES6 `class` 组件里不可用。它也许会在未来的 React 版本中被完全移除。
@@ -99,41 +99,41 @@ DOMElement getDOMNode()
### isMounted
```javascript
-bool isMounted()
+boolean isMounted()
```
如果组件渲染到了 DOM 中,`isMounted()` 返回 true,否则返回 `false`。可以使用该方法来控制对 `setState()` 和 `forceUpdate()` 的异步调用。
> 注意:
>
-> 这个方法在从 `React.Component` 扩展的 ES6 `class` 组件里不可用。它也许会在未来的 React 版本中被完全移除
+> 这个方法在从 `React.Component` 扩展的 ES6 `class` 组件里不可用。它也许会在未来的 React 版本中被完全移除,所以你也要移除它 [start migrating away from isMounted() now](/react/blog/2015/12/16/ismounted-antipattern.html)
### setProps
```javascript
-setProps(
+void setProps(
object nextProps,
[function callback]
)
```
-当和一个外部的 JavaScript 应用整合的时候,你也许会想用 `React.render()` 给 React 组件标示一个改变。
+当和一个外部的 JavaScript 应用整合的时候,你也许会想用 `ReactDOM.render()` 给 React 组件标示一个改变。
在根组件上调用 `setProps()` 会改变他的属性并触发一次重绘。另外,你可以提供一个可选的回调函数,一旦 `setProps` 完成并且组件被重绘它就执行。
> 注意:
>
-> 如果可能,上述的在同一个节点上再次调用 `React.render()` 的方法是优先替代的。它往往使更新更容易理解。(两种方法并没有显著的性能区别。)
+> 这个方法被弃用了并会很快移除.这个方法在从 `React.Component` 扩展的 ES6 `class` 组件里不可用. 取代调用 `setProps`,试着以新的 props 再次调用 `ReactDOM.render()`. 更多的注意事项,见我们的[blog post about using the Top Level API](/react/blog/2015/10/01/react-render-and-top-level-api.html)
>
-> 这个方法仅能在根组件上被调用。也就是说,它仅在直接传给 `React.render()` 的组件上可用,在它的子级上不可用。如果你倾向于在子组件上使用 `setProps()`,不要利用响应式更新,而是当子组件在 `render()` 中创建的时候传入新的 prop 到子组件中。
+> 如果可能,上述的在同一个节点上再次调用 `ReactDOM.render()` 的方法是优先替代的。它往往使更新更容易理解。(两种方法并没有显著的性能区别。)
>
-> 这个方法在从 `React.Component` 扩展的 ES6 `class` 组件里不可用。它也许会在未来的 React 版本中被完全移除
+> 这个方法仅能在根组件上被调用。也就是说,它仅在直接传给 `ReactDOM.render()` 的组件上可用,在它的子级上不可用。如果你倾向于在子组件上使用 `setProps()`,不要利用响应式更新,而是当子组件在 `render()` 中创建的时候传入新的 prop 到子组件中
### replaceProps
```javascript
-replaceProps(
+void replaceProps(
object nextProps,
[function callback]
)
@@ -143,4 +143,4 @@ replaceProps(
> 注意:
>
-> 这个方法在从 `React.Component` 扩展的 ES6 `class` 组件里不可用。它也许会在未来的 React 版本中被完全移除。
+> 这个方法被弃用了并会很快移除.这个方法在从 `React.Component` 扩展的 ES6 `class` 组件里不可用. 取代调用 `replaceProps`,试着以新的 props 再次调用 `ReactDOM.render()`. 更多的注意事项,见我们的[blog post about using the Top Level API](/react/blog/2015/10/01/react-render-and-top-level-api.html)
View
217 docs/docs/ref-03-component-specs.zh-CN.md
@@ -0,0 +1,217 @@
+---
+id: component-specs-zh-CN
+title: 组件的规范和生命周期
+permalink: component-specs-zh-CN.html
+prev: component-api-zh-CN.html
+next: tags-and-attributes-zh-CN.html
+---
+
+## 组件规范(Specifications)
+
+当调用 `React.createClass()` 创建一个组件类时,你应该提供一个包含有 `render` 方法以及可选的其他生命周期方法的 规范(Specifications)对象.
+
+> 注意:
+>
+> 同样可以使用单纯的 JavaScript 类作为组件类. 这些类可以实现大多数相同的方法,虽然有一些不同.更多关于不同的信息,请阅读我们关于[ES6 classes](/react/docs/reusable-components.html#es6-classes)的文档.
+
+### render
+
+```javascript
+ReactElement render()
+```
+
+ `render()` 是必须的
+
+ 当被调用时,它应该检查 `this.props``this.state` 并返回单个子元素.这个子元素即可以是一个 对原生DOM的虚拟表达(比如 `<div />``React.DOM.div()`)也可以是其他你自定义的复合组件.
+
+ 你也可以返回 `null``false` 来指示你不想要任何东西被渲染.幕后,React 渲染一个 `<noscript>` tag 来与我们当前的diffing算法协同工作.当返回 `null``false` ,`ReactDOM.findDOMNode(this)` 会返回 `null`.
+
+ `render()` 函数应该是纯净的,意味着它不改变组件的状态,它在每次调用时返回相同的结果,并且它不读和写 DOM 或者其他方式与浏览器互动(例如,使用 `setTimeout`).如果你需要与浏览器互动,在 `componentDidMount()` 里执行你的工作,或者其他生命周期方法里.保持 `render()` 纯净使服务器渲染更实用并且让组件更容易被思考.
+
+
+ ### getInitialState
+
+ ```javascript
+object getInitialState()
+```
+
+当组件被挂载时调用一次.返回值会被用作为 `this.state` 的初始值.
+
+
+### getDefaultProps
+
+```javascript
+object getDefaultProps()
+```
+
+在类被创建时调用一次并被缓存.在这个mapping里的值会被设置给 `this.props` 如果父组件没有指定对应的 prop (例如 使用一个 `in` 检查).
+
+这个方法在任何实例被创建之前调用,因此不能依赖于 `this.props`.另外,小心,任何被 `getDefaultProps()`返回的复杂对象会被跨实例共享,而不是被拷贝.
+
+
+### propTypes
+
+```javascript
+object propTypes
+```
+
+ `propTypes` 对象允许你验证传递到你的组建的 props.更多关于 `propTypes` 的信息,见 [Reusable Components](/react/docs/reusable-components.html).
+
+
+### mixins
+
+```javascript
+array mixins
+```
+
+ `mixins` 数组允许你用 mixins 来在多个组件间共享行为.更多关于 mixins 的信息,见 [Reusable Components](/react/docs/reusable-components.html).
+
+
+### statics
+
+```javascript
+object statics
+```
+
+`statics` 对象允许你定义可以在组件类上调用的静态方法.例如:
+
+```javascript
+var MyComponent = React.createClass({
+ statics: {
+ customMethod: function(foo) {
+ return foo === 'bar';
+ }
+ },
+ render: function() {
+ }
+});
+
+MyComponent.customMethod('bar'); // true
+```
+
+在这个块里定义的方法是 _static_,意味着你可以在任何组件实例被创建前运行他们,并且这些方法没有对你组件的 props 或 state 的访问权.如果你在静态方法里检查props的值,把调用者作为参数传入props给静态函数.
+
+
+### displayName
+
+```javascript
+string displayName
+```
+
+`displayName` 字符串被用在调试信息.JSX 自动设置这个值;见 [JSX in Depth](/react/docs/jsx-in-depth.html#the-transform).
+
+
+## Lifecycle Methods
+
+多种方法在组件生命周期的特定点上被执行.
+
+
+### Mounting: componentWillMount
+
+```javascript
+void componentWillMount()
+```
+
+被调用一次,即在客户端也在服务端,在最初的渲染发生之前 立即被调用.如果你在这个方法里调用 `setState` , `render()` 将会看到更新的 state 并不论state的变化只执行一次.
+
+
+### Mounting: componentDidMount
+
+```javascript
+void componentDidMount()
+```
+
+被调用一次,只在客户端(不在服务端),在最初的渲染发生之后 立即被调用.在生命周期的这个点上,你可以访问任何对你的子级的refs (比如 访问底层的DOM表达).子组件的 `componentDidMount()` 方法在父组件之前被调用.
+
+如果你想与其他 JavaScript 框架整合,用 `setTimeout``setInterval` 设置timers,或者发送 AJAX 请求,执行这些操作在此方法中.
+
+
+### Updating: componentWillReceiveProps
+
+```javascript
+void componentWillReceiveProps(
+ object nextProps
+)
+```
+
+当一个组件收到新的props时被调用.这个方法不会为最初的渲染调用.
+
+使用它作为响应 prop 转换的时机(在`render()` 被用 `this.setState()` 更新state调用 之前) .旧的 props 可以通过 `this.props` 访问. 在这个函数里调用 `this.setState()` 不会触发任何额外的渲染.
+
+```javascript
+componentWillReceiveProps: function(nextProps) {
+ this.setState({
+ likesIncreasing: nextProps.likeCount > this.props.likeCount
+ });
+}
+```
+
+> 注意:
+>
+> 并没有类似的 `componentWillReceiveState` 方法. 一个即将到来的 prop 转变可能会导致一个 state 变化,但是反之不是. 如果你需要实现一个对 state 变化相应的操作,使用 `componentWillUpdate`.
+
+
+### Updating: shouldComponentUpdate
+
+```javascript
+boolean shouldComponentUpdate(
+ object nextProps, object nextState
+)
+```
+
+当新的props或者state被收到,在渲染前被调用.这个方法不会在最初的渲染或者 `forceUpdate` 时被调用.
+
+使用此方法作为一个 `return false` 的时机,当你确定新的 props 和 state 的转换不需要组件更新时.
+
+```javascript
+shouldComponentUpdate: function(nextProps, nextState) {
+ return nextProps.id !== this.props.id;
+}
+```
+
+如果 `shouldComponentUpdate` 返回false, `render()` 会在下次state变化前被完全跳过. 另外,`componentWillUpdate``componentDidUpdate` 将不会被调用.
+
+默认情况下, `shouldComponentUpdate` 总是返回 `true` 来阻止当 `state` 突变时的细微bug,但是如果你仔细的把 `state` 作为不变量对待并只从 `render()`里的 `props``state`读,你就可以用一个比较旧的props和state与他们的替换者的实现来重写 `shouldComponentUpdate`.
+
+如果性能是瓶颈,尤其是随着成百上千的组件,使用 `shouldComponentUpdate` 来加速你的app.
+
+
+### Updating: componentWillUpdate
+
+```javascript
+void componentWillUpdate(
+ object nextProps, object nextState
+)
+```
+
+当新的props或者state被接受时,在渲染前被立即调用.这个方法不会被初始渲染调用.
+
+使用这个方法作为 在更新发生前执行一些准备 的时机.
+
+> Note:
+>
+>*不能* 在这个方法里使用 `this.setState()` .如果你需要响应一个prop变化来更新state,使用 `componentWillReceiveProps` 来替代.
+
+
+### Updating: componentDidUpdate
+
+```javascript
+void componentDidUpdate(
+ object prevProps, object prevState
+)
+```
+
+在组件的更新被刷新到DOM后立即被调用.这个方法不会被初始渲染调用.
+
+使用这个方法作为 当组件被更新后在DOM上操作 的时机.
+
+
+### Unmounting: componentWillUnmount
+
+```javascript
+void componentWillUnmount()
+```
+
+在组件被从DOM卸载 前 被立即调用.
+
+在这个方法里执行一些必要的清理操作,比如无效化 timers 或者清理任何被 `componentDidMount` 创建的DOM元素.
View
90 docs/docs/ref-04-tags-and-attributes.zh-CN.md
@@ -0,0 +1,90 @@
+---
+id: tags-and-attributes-zh-CN
+title: Tags和属性
+permalink: tags-and-attributes-zh-CN.html
+prev: component-specs-zh-CN.html
+next: events-zh-CN.html
+---
+
+## 支持的Tags
+
+React试着支持所有常见的元素.如果你需要一个没有列在这里的元素,请 [file an issue](https://github.com/facebook/react/issues/new).
+
+### HTML 元素
+
+下面的HTML是被支持的:
+
+```
+a abbr address area article aside audio b base bdi bdo big blockquote body br
+button canvas caption cite code col colgroup data datalist dd del details dfn
+dialog div dl dt em embed fieldset figcaption figure footer form h1 h2 h3 h4 h5
+h6 head header hr html i iframe img input ins kbd keygen label legend li link
+main map mark menu menuitem meta meter nav noscript object ol optgroup option
+output p param picture pre progress q rp rt ruby s samp script section select
+small source span strong style sub summary sup table tbody td textarea tfoot th
+thead time title tr track u ul var video wbr
+```
+
+### SVG 元素
+
+下面的 SVG 元素是被支持的:
+
+```
+circle clipPath defs ellipse g line linearGradient mask path pattern polygon polyline
+radialGradient rect stop svg text tspan
+```
+
+你也许对 [react-art](https://github.com/facebook/react-art)有兴趣,一个让React绘制Canvas, SVG, 或者 VML (for IE8) 的绘制库.
+
+
+## 支持的属性
+
+React支持所有的 `data-*``aria-*` 以及下列的属性.
+
+> 注意:
+>
+> 所有的属性都是 camel-cased ,`class``for` 分别是 `className``htmlFor`,来符合DOM API 规范.
+
+关于事件的列表,见 [Supported Events](/react/docs/events.html).
+
+### HTML 属性
+
+下面的标准属性是被支持的:
+
+```
+accept acceptCharset accessKey action allowFullScreen allowTransparency alt
+async autoComplete autoFocus autoPlay capture cellPadding cellSpacing charSet
+challenge checked classID className cols colSpan content contentEditable contextMenu
+controls coords crossOrigin data dateTime defer dir disabled download draggable
+encType form formAction formEncType formMethod formNoValidate formTarget frameBorder
+headers height hidden high href hrefLang htmlFor httpEquiv icon id inputMode
+keyParams keyType label lang list loop low manifest marginHeight marginWidth max
+maxLength media mediaGroup method min minLength multiple muted name noValidate open
+optimum pattern placeholder poster preload radioGroup readOnly rel required role
+rows rowSpan sandbox scope scoped scrolling seamless selected shape size sizes
+span spellCheck src srcDoc srcSet start step style summary tabIndex target title
+type useMap value width wmode wrap
+```
+
+另外,支持下面的非标准属性:
+
+- `autoCapitalize autoCorrect` for Mobile Safari.
+- `property` for [Open Graph](http://ogp.me/) meta tags.
+- `itemProp itemScope itemType itemRef itemID` for [HTML5 microdata](http://schema.org/docs/gs.html).
+- `unselectable` for Internet Explorer.
+- `results autoSave` for WebKit/Blink input fields of type `search`.
+
+同样有React规范的属性 `dangerouslySetInnerHTML` ([more here](/react/docs/special-non-dom-attributes.html)),用于直接插入HTML字符串到组件里.
+
+### SVG 属性
+
+```
+clipPath cx cy d dx dy fill fillOpacity fontFamily
+fontSize fx fy gradientTransform gradientUnits markerEnd
+markerMid markerStart offset opacity patternContentUnits
+patternUnits points preserveAspectRatio r rx ry spreadMethod
+stopColor stopOpacity stroke strokeDasharray strokeLinecap
+strokeOpacity strokeWidth textAnchor transform version
+viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole
+xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y
+```
View
50 docs/docs/ref-05-events.zh-CN.md
@@ -31,12 +31,37 @@ string type
> 注意:
>
-> React v0.12 中,事件处理程序返回 `false` 不再停止事件传播,取而代之,应该根据需要手动触发 `e.stopPropagation()``e.preventDefault()`
+> React v0.14 中,事件处理程序返回 `false` 不再停止事件传播,取而代之,应该根据需要手动触发 `e.stopPropagation()``e.preventDefault()`
+## 事件池
+
+`SyntheticEvent` 是池化的. 这意味着 `SyntheticEvent` 对象将会被重用并且所有的属性都会在事件回调被调用后被 nullified.
+这是因为性能的原因.
+因此,你不能异步的访问事件.
+
+```javascript
+function onClick(event) {
+ console.log(event); // => nullified object.
+ console.log(event.type); // => "click"
+ var eventType = event.type; // => "click"
+
+ setTimeout(function() {
+ console.log(event.type); // => null
+ console.log(eventType); // => "click"
+ }, 0);
+
+ this.setState({clickEvent: event}); // Won't work. this.state.clickEvent will only contain null values.
+ this.setState({eventType: event.type}); // You can still export event properties.
+}
+```
+
+> 注意:
+>
+> 如果你想异步访问事件属性,你应该在事件上调用 `event.persist()` ,这会从池中移除合成事件并允许对事件的引用被用会保留.
## 支持的事件
-React 将事件统一化,使事件在不同浏览器上有一致的属性
+React 将事件统一化,使事件在不同浏览器上有一致的属性.
下面的事件处理程序在事件冒泡阶段被触发。如果要注册事件捕获处理程序,应该使用 `Capture` 事件,例如使用 `onClickCapture` 处理点击事件的捕获阶段,而不是 `onClick`
@@ -56,6 +81,22 @@ DOMDataTransfer clipboardData
```
+### Composition 事件
+
+事件名称:
+
+```
+onCompositionEnd onCompositionStart onCompositionUpdate
+```
+
+属性:
+
+```javascript
+string data
+
+```
+
+
### 键盘事件
事件名称:
@@ -64,7 +105,7 @@ DOMDataTransfer clipboardData
onKeyDown onKeyPress onKeyUp
```
-属性
+属性:
```javascript
boolean altKey
@@ -96,6 +137,7 @@ onFocus onBlur
DOMEventTarget relatedTarget
```
+焦点事件在所有的React DOM上工作,不仅仅是表单元素.
### 表单事件
@@ -118,6 +160,8 @@ onDragLeave onDragOver onDragStart onDrop onMouseDown onMouseEnter onMouseLeave
onMouseMove onMouseOut onMouseOver onMouseUp
```
+`onMouseEnter``onMouseLeave` 事件从离开的元素传播到进入的元素,代替冒泡排序并且没有捕获阶段.
+
属性:
```javascript
View
16 docs/docs/ref-06-dom-differences.zh-CN.md
@@ -0,0 +1,16 @@
+---
+id: dom-differences-zh-CN
+title: DOM 的不同之处
+permalink: dom-differences-zh-CN.html
+prev: events-zh-CN.html
+next: special-non-dom-attributes-zh-CN.html
+---
+
+React 实现了一个浏览器无关的 事件和DOM 系统,原因是为了性能和跨浏览器的兼容性.我们利用这个机会来清理了一些浏览器DOM实现的一些粗糙边缘.
+
+* 所有的 DOM properties 和 attributes (包括事件处理器) 都应该 camelCased 来保持和标准的 JavaScript 风格一致.我们在这里故意打破了这个规范是因为规范是不一致的. **然而**,`data-*``aria-*` attributes [conform to the specs](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#data-*) 应该只 lower-cased.
+* `style` attribute 接受 camelCased properties 的JavaScript对象 而不是一个CSS字符串. 这保持了和 DOM `style` JavaScript property 的一致,更有效率,而且阻止了XSS安全漏洞.
+* 因为 `class``for` 是 JavaScript的保留字,内建[DOM nodes](http://javascript.info/tutorial/dom-nodes)的JSX元素 应该分别使用 attribute名`className``htmlFor` ,(比如 `<div className="foo" />`).自定义元素应该直接使用 `class``for` (例如. `<my-tag class="foo" />` ).
+* 所有事件对象遵循 W3C 规范,所有事件(包括提交)正确按W3C规范冒泡.详见[Event System](/react/docs/events.html).
+* `onChange` 事件表现的像你期望的那样:不论何时一个表单域改变了这个事件就会激发,而不是模糊的不一致.我们故意打破了已有浏览器的行为,因为 `onChange` 对于他的行为来说用词不当,并且React依赖于这个事件来实时响应用户的输入.详见[Forms](/react/docs/forms.html).
+* 表单 输入attributes 类似 `value``checked`,就像`textarea`一样[More here](/react/docs/forms.html).
View
13 docs/docs/ref-07-special-non-dom-attributes.zh-CN.md
@@ -0,0 +1,13 @@
+---
+id: special-non-dom-attributes-zh-CN
+title: 特殊的 Non-DOM Attributes
+permalink: special-non-dom-attributes-zh-CN.html
+prev: dom-differences-zh-CN.html
+next: reconciliation-zh-CN.html
+---
+
+和 [DOM 的不同之处](/react/docs/dom-differences-zh-CN.html)相比, React 提供了一些不存在于DOM的 attributes .
+
+- `key`: 一个可选的.独特的标识.当你的组件穿梭于 `render` 的pass,它也许会因为diff算法被摧毁和重建.赋予它一个持久的key保证这个component可达.详见 [这里](/react/docs/multiple-components.html#dynamic-children).
+- `ref`: 见 [这里](/react/docs/more-about-refs.html).
+- `dangerouslySetInnerHTML`: 提供了直接插入raw HTML的能力,主要是为了与操纵DOM字符串的库协作.详见 [这里](/react/tips/dangerously-set-inner-html.html).
View
193 docs/docs/ref-10-glossary.zh-CN.md
@@ -0,0 +1,193 @@
+---
+id: glossary-zh-CN
+title: React (虚拟) DOM 术语
+permalink: glossary-zh-CN.html
+prev: webcomponents-zh-CN.html
+---
+
+在 React 的术语中,有五个要重点区分的核心类型:
+
+- [ReactElement / ReactElement Factory](#react-elements)
+- [ReactNode](#react-nodes)
+- [ReactComponent / ReactComponent Class](#react-components)
+
+## React Elements(React 元素)
+
+React里的首要类型是 `ReactElement`.它有四个 properties:`type`, `props`, `key``ref`.它没有方法,在 prototype 上什么也没有.
+
+你可以通过 `React.createElement` 来创建这些对象.
+
+```javascript
+var root = React.createElement('div');
+```
+
+要渲染一个新的树到DOM上,你创建 `ReactElement`s 并传递他们到 `ReactDOM.render` 伴随着一个标准的 DOM `Element` (`HTMLElement``SVGElement`).`ReactElement`s 不要与 DOM `Element`s 混淆.`ReactElement` 是一个轻的,有状态的,不可变的,虚拟的DOM `Element` 的表达.它是一个虚拟 DOM.
+
+```javascript
+ReactDOM.render(root, document.getElementById('example'));
+```
+
+要给一个DOM元素添加 properties,传递一个properties 对象作为第二个参数,第三个参数传递子级.
+
+```javascript
+var child = React.createElement('li', null, 'Text Content');
+var root = React.createElement('ul', { className: 'my-list' }, child);
+ReactDOM.render(root, document.getElementById('example'));
+```
+
+如果你使用 React JSX,这些`ReactElement`s 已经为你创建了.所以 这是等价的:
+
+```javascript
+var root = <ul className="my-list">
+ <li>Text Content</li>
+ </ul>;
+ReactDOM.render(root, document.getElementById('example'));
+```
+
+### Factories(工厂)
+
+`ReactElement`-工厂 是一个产生特定 `type` property的 `ReactElement` 的函数.React有一个为你内建的辅助工具来创建工厂.它想这样起作用:
+
+```javascript
+function createFactory(type) {
+ return React.createElement.bind(null, type);
+}
+```
+
+它允许你创建一个方便的速记 来代替每次输入 `React.createElement('div')` .
+
+```javascript
+var div = React.createFactory('div');
+var root = div({ className: 'my-div' });
+ReactDOM.render(root, document.getElementById('example'));
+```
+
+React 已经具备用于常用 HTML tags的内建工厂
+
+```javascript
+var root = React.DOM.ul({ className: 'my-list' },
+ React.DOM.li(null, 'Text Content')
+ );
+```
+
+如果你使用JSX 你没有必要使用工厂.JSX已经为创建 `ReactElement`s 提供了一个 方便的速记.
+
+
+## React Nodes
+
+一个 `ReactNode` 可以是:
+
+- `ReactElement`
+- `string` (aka `ReactText`)
+- `number` (aka `ReactText`)
+- Array of `ReactNode`s (aka `ReactFragment`)
+
+他们被用作其他`ReactElement`s的properties来表示子级.事实上他们创建了一个 `ReactElement`s 的树.
+
+
+## React Components
+
+你可以使用 React只使用`ReactElement`s 但是要真正利用React,你将要使用 `ReactComponent`s 来创建内嵌 state 的封装.
+
+一个 `ReactComponent` 类就是一个 JavaScript 类 (或者 "constructor function").
+
+```javascript
+var MyComponent = React.createClass({
+ render: function() {
+ ...
+ }
+});
+```
+
+当这个构造函数被调用,期望返回一个至少有一个 `render` 方法的对象.这个对象被称为一个 `ReactComponent`.
+
+```javascript
+var component = new MyComponent(props); // never do this
+```
+
+与测试不同,你可能通常 *绝不会* 亲自调用这个构造函数.React 为你调用它.
+
+作为替代,你传递 `ReactComponent` 类到 `createElement`,你得到一个 `ReactElement`.
+
+```javascript
+var element = React.createElement(MyComponent);
+```
+
+或者用 JSX:
+
+```javascript
+var element = <MyComponent />;
+```
+
+当这个被传给 `ReactDOM.render`,React 会为你调用构造函数并创建一个 `ReactComponent`,返回给你.
+
+```javascript
+var component = ReactDOM.render(element, document.getElementById('example'));
+```
+
+如果你保持用相同类型的 `ReactElement` 和相同的DOM `Element`容器调用 `ReactDOM.render` ,它总是会返回相同的实例.这个实例是状态化的.
+
+```javascript
+var componentA = ReactDOM.render(<MyComponent />, document.getElementById('example'));
+var componentB = ReactDOM.render(<MyComponent />, document.getElementById('example'));
+componentA === componentB; // true
+```
+
+这就是为什么你不应该构造你自己的实例.作为替代,`ReactElement` 在它被构造以前 是一个虚拟的 `ReactComponent`.一个老的和新的`ReactElement` 可以被比较来判断 一个新的 `ReactComponent` 实例是否需要被创建或者已经存在的是否应该被重用.
+
+ `ReactComponent``render` 方法被期望返回另一个 `ReactElement`.这允许这些组件被结构化.最后,渲染分解为 带着一个 `string` tag的`ReactElement`,它实例化一个 DOM `Element` 实例并把它插入document里.
+
+
+## Formal Type Definitions
+
+### Entry Point
+
+```
+ReactDOM.render = (ReactElement, HTMLElement | SVGElement) => ReactComponent;
+```
+
+### Nodes and Elements
+
+```
+type ReactNode = ReactElement | ReactFragment | ReactText;
+
+type ReactElement = ReactComponentElement | ReactDOMElement;
+
+type ReactDOMElement = {
+ type : string,
+ props : {
+ children : ReactNodeList,
+ className : string,
+ etc.
+ },
+ key : string | boolean | number | null,
+ ref : string | null
+};
+
+type ReactComponentElement<TProps> = {
+ type : ReactClass<TProps>,
+ props : TProps,
+ key : string | boolean | number | null,
+ ref : string | null
+};
+
+type ReactFragment = Array<ReactNode | ReactEmpty>;
+
+type ReactNodeList = ReactNode | ReactEmpty;
+
+type ReactText = string | number;
+
+type ReactEmpty = null | undefined | boolean;
+```
+
+### Classes and Components
+
+```
+type ReactClass<TProps> = (TProps) => ReactComponent<TProps>;
+
+type ReactComponent<TProps> = {
+ props : TProps,
+ render : () => ReactElement
+};
+```
+
View
2 docs/docs/thinking-in-react.zh-CN.md
@@ -69,7 +69,7 @@ React许多优秀的部分之一是它如何使你随着构建 app 来思考 app
你可以自顶向下或自底向上的构建.也就是说,你可以既从较高的层级(如 从 `FilterableProductTable` 开始) 也可以从较低的层级(`ProductRow`)开始构建组件. 在较简单的例子里,通常自顶向下要容易一些,然而在更大的项目上 自底向上更容易,并且伴随着构建写测试较容易.
-在这一步的最后,你会有一个渲染你数据模型的可重用的组件库. 这些组件将只含有 `render()` 方法因为这是一个你的app的静态版本. 在层级顶端的组件 (`FilterableProductTable`) 将会接受你的数据模型作为一个prop.如果你对你的底层数据模型做了变化并且再次调用 `React.render()` ,UI将会更新.很容易看到你的UI是如何更新以及哪里来作出变动,因为这里没有任何复杂的事情发生. React的 **单向数据流** (也被称为 *单向绑定* )保持了每个东西模块化和快速.
+在这一步的最后,你会有一个渲染你数据模型的可重用的组件库. 这些组件将只含有 `render()` 方法因为这是一个你的app的静态版本. 在层级顶端的组件 (`FilterableProductTable`) 将会接受你的数据模型作为一个prop.如果你对你的底层数据模型做了变化并且再次调用 `ReactDOM.render()` ,UI将会更新.很容易看到你的UI是如何更新以及哪里来作出变动,因为这里没有任何复杂的事情发生. React的 **单向数据流** (也被称为 *单向绑定* )保持了每个东西模块化和快速.
如果你执行这步需要帮助,请参考 [React docs](/react/docs/) .
View
173 docs/docs/videos.zh-CN.md
@@ -0,0 +1,173 @@
+---
+id: videos-zh-CN
+title: 视频
+permalink: videos-zh-CN.html
+prev: conferences-zh-CN.html
+next: complementary-tools-zh-CN.html
+---
+
+### Rethinking best practices - JSConf.eu
+
+<iframe width="650" height="366" src="https://www.youtube-nocookie.com/embed/x7cQ3mrcKaY" frameborder="0" allowfullscreen></iframe>
+
+"在 Facebook 和 Instagram, 我们正在努力挑战React在web上能达到的极限。我的讲话会从对框架的简单介绍开始,然后深入三个有争议的话题:扔掉模板的概念并用JavaScript构建views, 当数据改变 “re-rendering” 你的整个应用,以及一个DOM和events的轻量级实现。" -- [Pete Hunt](http://www.petehunt.net/)
+
+* * *
+
+### Thinking in react - tagtree.tv
+
+一个 [tagtree.tv](http://tagtree.tv/) 传达 [Thinking in React](/react/docs/thinking-in-react.html) 原则的视频 在构建一个简单app时。
+<figure>[![](/react/img/docs/thinking-in-react-tagtree.png)](http://tagtree.tv/thinking-in-react)</figure>
+
+* * *
+
+### Secrets of the Virtual DOM - MtnWest JS
+
+<iframe width="650" height="366" src="https://www.youtube-nocookie.com/embed/h3KksH8gfcQ" frameborder="0" allowfullscreen></iframe>
+
+"在这次讲座里,我会讨论为什么我们构建了一个虚拟 DOM,它比起其他系统如何,以及它与未来浏览器技术的关系。" -- [Pete Hunt](http://www.petehunt.net/)
+
+* * *
+
+### Going big with React ###
+
+"理论上,所有的JS框架都大有可为:干净的实现,快速的代码设计,完美的执行。但是当你压力测试时Javascript会怎样?当你丢进6MB的代码时会怎样?在这次演讲中,我们会探究React在高压环境下如何表现,以及它如何帮助我们的团队在大规模时构建安全代码。 "
+<figure>[![](https://i.vimeocdn.com/video/481670116_650.jpg)](https://skillsmatter.com/skillscasts/5429-going-big-with-react#video)</figure>
+
+* * *
+
+### CodeWinds
+
+[Pete Hunt](http://www.petehunt.net/) 与 [Jeff Barczewski](http://jeff.barczewski.com/) 在 CodeWinds Episode 4 上关于 React 的谈话.
+<figure>[![](/react/img/docs/codewinds-004.png)](http://codewinds.com/4)</figure>
+
+<table width="100%"><tr><td>
+02:08 - 什么是React,为什么我们用它?<br />
+03:08 - ClojureScript 和 React 的共生关系<br />
+04:54 - React 的历史以及为什么它被创造<br />
+09:43 - 用React更新Web页面,而不绑定数据<br />
+13:11 - 用虚拟DOM来改变浏览器DOM<br />
+13:57 - 用React编程,绘制目标HTML,canvas和其他<br />
+16:45 - 和设计师一起工作,对比于Ember 和 AngularJS<br />
+21:45 - JSX编译器桥接HTML和 React javascript<br />
+23:50 - React的自动绑定JSX以及浏览器内工具<br />
+24:50 - 用React工作的提示和技巧,入门<br />
+</td><td>
+27:17 - 在服务器端用Node.js渲染HTML。后端渲染<br />
+29:20 - React在Facebook通过优胜劣汰进化<br />
+30:15 - 用web sockets,在服务器端和客户端持有状态的想法持有<br />
+32:05 - 多用户React - 用 Firebase 分布式共享可变状态<br />
+33:03 - 用状态转换,事件重放来更好的调式React<br />
+34:08 - 来自Web组件的不同之处<br />
+34:25 - 使用React的著名公司<br />
+35:16 - 一个React的后端插件可以用来创建PDF吗?<br />
+36:30 - React的未来,下一步是什么?<br />
+39:38 - 贡献和获得帮助<br />
+</td></tr></table>
+
+[Read the episode notes](http://codewinds.com/4)
+
+* * *
+
+### JavaScript Jabber
+
+[Pete Hunt](http://www.petehunt.net/) 和 [Jordan Walke](https://github.com/jordwalke) 在 JavaScript Jabber 73 上关于React的谈话.
+<figure>[![](/react/img/docs/javascript-jabber.png)](http://javascriptjabber.com/073-jsj-react-with-pete-hunt-and-jordan-walke/#content)</figure>
+
+<table width="100%"><tr><td>
+01:34 – Pete Hunt 介绍<br />
+02:45 – Jordan Walke 介绍<br />
+04:15 – React<br />
+06:38 – 60 帧每秒<br />
+09:34 – 数据绑定<br />
+12:31 – 性能<br />
+17:39 – Diffing 算法<br />
+19:36 – DOM 操纵
+</td><td>
+23:06 – 支持 node.js<br />
+24:03 – rendr<br />
+26:02 – JSX<br />
+30:31 – requestAnimationFrame<br />
+34:15 – React 和应用<br />
+38:12 – React 用户 Khan Academy<br />
+39:53 – 使其工作
+</td></tr></table>
+
+[Read the full transcript](http://javascriptjabber.com/073-jsj-react-with-pete-hunt-and-jordan-walke/)
+
+* * *
+
+### Introduction to React.js - Facebook Seattle
+
+<iframe width="650" height="366" src="https://www.youtube-nocookie.com/embed/XxVg_s8xAms" frameborder="0" allowfullscreen></iframe>
+
+由 [Tom Occhino](http://tomocchino.com/) 和 [Jordan Walke](https://github.com/jordwalke)
+
+* * *
+
+### Backbone + React + Middleman Screencast
+<iframe width="650" height="488" src="https://www.youtube-nocookie.com/embed/iul1fWHVU6A" frameborder="0" allowfullscreen></iframe>
+
+Backbone 是一个在用React实现 REST API 接口的极好方法。这个屏博展示了用 [Backbone-React-Component](https://github.com/magalhas/backbone-react-component)如何整合两者. Middleman 是在本例中使用的框架但很容易被替换成其他框架。对此可支持的template可以在[这里](https://github.com/jbhatab/middleman-backbone-react-template) 找到. -- [Open Minded Innovations](http://www.openmindedinnovations.com/)
+
+* * *
+
+### Developing User Interfaces With React - Super VanJS
+
+<iframe width="650" height="366" src="https://www.youtube-nocookie.com/embed/1OeXsL5mr4g" frameborder="0" allowfullscreen></iframe>
+
+来自 [Steven Luscher](https://github.com/steveluscher)
+
+* * *
+
+### Introduction to React - LAWebSpeed meetup
+
+<iframe width="650" height="366" src="https://www.youtube-nocookie.com/embed/SMMRJif5QW0" frameborder="0" allowfullscreen></iframe>
+
+来自 [Stoyan Stefanov](http://www.phpied.com/)
+
+* * *
+
+### React, or how to make life simpler - FrontEnd Dev Conf '14
+
+<iframe width="650" height="366" src="https://www.youtube-nocookie.com/embed/YJNUK0EA_Jo" frameborder="0" allowfullscreen></iframe>
+
+**俄语** by [Alexander Solovyov](http://solovyov.net/)
+
+* * *
+
+### "Functional DOM programming" - Meteor DevShop 11
+
+<iframe width="650" height="366" src="https://www.youtube-nocookie.com/embed/qqVbr_LaCIo" frameborder="0" allowfullscreen></iframe>
+
+* * *
+
+### "Rethinking Web App Development at Facebook" - Facebook F8 Conference 2014
+
+<iframe width="650" height="366" src="https://www.youtube-nocookie.com/embed/nYkdrAPrdcw" frameborder="0" allowfullscreen></iframe>
+
+* * *
+
+### React and Flux: Building Applications with a Unidirectional Data Flow - Forward JS 2014
+
+<iframe width="650" height="366" src="https://www.youtube-nocookie.com/embed/i__969noyAM" frameborder="0" allowfullscreen></iframe>
+
+Facebook 工程师 [Bill Fisher](https://twitter.com/fisherwebdev) 和 [Jing Chen](https://twitter.com/jingc) 谈论 Flux 和 React, 以及如何使用单向数据流的程序架构清理他们的代码 .
+
+* * *
+
+### Server-Side Rendering of Isomorphic Apps at SoundCloud
+
+<iframe src="https://player.vimeo.com/video/108488724" width="650" height="365" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
+
+来自 [Andres Suarez](https://github.com/zertosh) 的演练,关于 [SoundCloud](https://developers.soundcloud.com/blog/) 如何使用 React 和 Flux 在服务器端渲染.
+
+[幻灯片和示例代码](https://github.com/zertosh/ssr-demo-kit)
+
+* * *
+
+### Introducing React Native (+Playlist) - React.js Conf 2015
+
+<iframe width="650" height="366" src="https://www.youtube-nocookie.com/embed/KVZ-P-ZI6W4?list=PLb0IAmt7-GS1cbw4qonlQztYV1TAW0sCr" frameborder="0" allowfullscreen></iframe>
+
+[Tom Occhino](https://twitter.com/tomocchino) 回顾了React的过去和现在,在2015年。梳理了下一步要做什么。

0 comments on commit badc15e

Please sign in to comment.
Something went wrong with that request. Please try again.