{"body":"Update zh-CN docs.","parents":["e147c4942b6b0c5df426cadd1c7e88f3d2956233","2a5e6b3c91deeb29417102311446c5e69258a2a7"],"patch":"diff --git a\/docs\/docs\/02.1-jsx-in-depth.zh-CN.md b\/docs\/docs\/02.1-jsx-in-depth.zh-CN.md\nindex 8119196ace..c44423113d 100644\n--- a\/docs\/docs\/02.1-jsx-in-depth.zh-CN.md\n+++ b\/docs\/docs\/02.1-jsx-in-depth.zh-CN.md\n@@ -204,7 +204,7 @@ var content = React.createElement(\n \n ### 注释\n \n-JSX 里添加注释很容易；它们只是 JS 表达式而已。你仅仅需要小心的是当你在一个标签的子节点块(props.children)时，要用 `{}` 包围要注释的部分。\n+JSX 里添加注释很容易；它们只是 JS 表达式而已。你仅仅需要小心的是当你在一个标签的子节点块时，要用 `{}` 包围要注释的部分。\n \n ```javascript\n var content = (\ndiff --git a\/docs\/docs\/08-working-with-the-browser-zh-CN.md b\/docs\/docs\/08-working-with-the-browser-zh-CN.md\nnew file mode 100644\nindex 0000000000..1cecd80274\n--- \/dev\/null\n+++ b\/docs\/docs\/08-working-with-the-browser-zh-CN.md\n@@ -0,0 +1,148 @@\n+---\n+id: working-with-the-browser-zh-CN\n+title: 与浏览器协作\n+permalink: working-with-the-browser-zh-CN.html\n+prev: forms-zh-CN.html\n+next: more-about-refs-zh-CN.html\n+---\n+\n+React提供了强大的抽象机制使你在大多数情况下免于直接接触DOM，但有时你仅仅只需要访问底层API，也许是为了与第三方库或者已有的代码协作。\n+\n+\n+## 虚拟DOM \n+\n+React如此快速是因为它从不直接操作DOM。React维持了一个快速的内存中的DOM表示。`render()` 方法返回一个DOM的*描述*，然后React能根据内存中的描述diff此描述来计算出最快速的方法更新浏览器。\n+\n+此外，React实现了一个完备的合成事件(synthetic event)系统，以使得所有的事件对象都被保证符合W3C细则，而不论各个浏览器的怪癖，并且所有事件跨浏览器地一致并高效的冒泡（bubbles），你甚至能在IE8里使用一些HTML5事件！\n+\n+大多数时间你应该和React的\"伪造浏览器\"呆在一起，因为它更高性能并且容易推理。然而，有时你只需要访问底层API，或许是为了与第三方库比如一个jQuery插件协作。React为你提供了安全仓口来直接使用底层API。\n+\n+\n+## Refs 和 findDOMNode()\n+\n+为了与浏览器互动，你需要一个指向DOM node的引用。React有一个函数`React.findDOMNode(component)` ，你能调用以得到一个指向指向组件的DOM node的引用。\n+\n+> 注意:\n+>\n+> `findDOMNode()` 只作用于已挂载的组件（即，已经放置于DOM中的组件）。如果你尝试在还没有被挂载的组件上调用此函数（比如在`render()` 里有待被创建的组件上调用`findDOMNode()`将会抛出一个异常）\n+\n+为了获得一个指向React组件的引用，你可以要么使用`this` 来得到当前React组件，要么使用refs来引用你拥有的组件。它们像这样工作：\n+\n+```javascript\n+var MyComponent = React.createClass({\n+ handleClick: function() {\n+ \/\/ 明确的强制text input使用原生DOM API。\n+ React.findDOMNode(this.refs.myTextInput).focus();\n+ },\n+ render: function() {\n+ \/\/ 当组件被挂载时\n+ \/\/ ref属性给this.refs添加了一个指向指向组件的引用\n+ return (\n+

\n+ \n+ \n+ <\/div>\n+ );\n+ }\n+});\n+\n+React.render(\n+ ,\n+ document.getElementById('example')\n+);\n+```\n+\n+\n+## 更多关于Refs\n+\n+要学习更多有关refs，包括更有效使用它们的方法，请参见[more about refs](\/react\/docs\/more-about-refs.html) 文档。\n+\n+\n+## 组件的生命周期\n+\n+组件的生命周期有三个主要部分：\n+\n+* **挂载:** 组件被注入DOM。\n+* **更新:** 组件被重新渲染来决定DOM是否应被更新。\n+* **卸载:** 组件从DOM中被移除。\n+\n+React提供生命周期方法，以便你可以指定钩挂到这个过程上。我们提供了 **will** 方法，该方法在某事发生前被调用，**did**方法，在某事发生后被调用。\n+\n+\n+### 挂载\n+\n+* `getInitialState(): object` 在组件挂载前被调用. 有状态组件(Stateful components) 应该实现此函数并返回初始state的数据。\n+* `componentWillMount()` 在挂载发生前被立即调用。 \n+* `componentDidMount()` 在挂载发生后被立即调用。需要DOM node的初始化应该放在这里。 \n+\n+\n+### 更新\n+\n+* `componentWillReceiveProps(object nextProps)` 当挂载的组件接收到新的props时被调用。此方法应该被用于比较`this.props` 和 `nextProps`以用于使用`this.setState()`执行状态转换。\n+* `shouldComponentUpdate(object nextProps, object nextState): boolean` 当组件决定任何改变是否要更新到DOM时被调用。作为一个优化实现比较`this.props` 和 `nextProps` 、`this.state` 和 `nextState` ，如果React应该跳过更新，返回`false`。 \n+* `componentWillUpdate(object nextProps, object nextState)` 在更新发生前被立即调用。你不能在此调用`this.setState()`。\n+* `componentDidUpdate(object prevProps, object prevState)` 在更新发生后被立即调用。\n+\n+\n+### 卸载\n+\n+* `componentWillUnmount()` 在组件被卸载和摧毁后被立即调用。清理应该放在这里。\n+\n+\n+### Mounted Methods\n+\n+_Mounted_ 复合组件同样支持以下方法:\n+\n+* `findDOMNode(): DOMElement` 能够在任何已挂载的组件上调用以便于获取指向它渲染的DOM node的引用。\n+* `forceUpdate()` 能在任何已挂载的组件上调用，当你知道一些更深层次的组件状态变化了但没有使用 `this.setState()`。\n+\n+\n+## 浏览器支持和填充物(polyfills)\n+\n+在 Facebook，我们支持老浏览器，包括IE8。我们由来已久的有适当的填充物(polyfills)来让我们写前瞻性的js。这意味着我们在代码库中没有一堆散落在各处的技巧(hacks)并且我们依然能期望我们的代码\"可行（just work）\"。例如，我可以只写 `Date.now()`，而不是额外看到`+new Date()`。既然开源的React和我们内部使用的一样，我们也应用了这种使用前瞻性js的哲学。\n+\n+除了这种哲学外，我们也采用了这样的立场，我们，作为一个JS库的作者，不应该把polyfills作为我们库的一部分。如果所有的库这样做，就有很大的机会发送同样的polyfill多次，这可能是一个相当大的无用代码。如果你的产品需要支援老的浏览器，你很有可能已经在使用某些东西比如[es5-shim](https:\/\/github.com\/es-shims\/es5-shim)。\n+\n+\n+### 需要用来支持旧浏览器的Polyfills \n+\n+来自 [kriskowal's es5-shim](https:\/\/github.com\/es-shims\/es5-shim)的`es5-shim.js` 提供了如下React需要的东西：\n+\n+* `Array.isArray`\n+* `Array.prototype.every`\n+* `Array.prototype.forEach`\n+* `Array.prototype.indexOf`\n+* `Array.prototype.map`\n+* `Date.now`\n+* `Function.prototype.bind`\n+* `Object.keys`\n+* `String.prototype.split`\n+* `String.prototype.trim`\n+\n+同样来自 [kriskowal's es5-shim](https:\/\/github.com\/es-shims\/es5-shim)的`es5-sham.js`, 提供了如下React需要的东西：\n+\n+* `Object.create`\n+* `Object.freeze`\n+\n+非最小化的React build需要如下，来自[paulmillr's console-polyfill](https:\/\/github.com\/paulmillr\/console-polyfill).\n+\n+* `console.*`\n+\n+当在IE8里使用HTML5元素，包括`

`, `

`, 和 `

dillon1000/react

Files changed