From 1c57e2de4c68f36c34c1692f013700e81b03c79b Mon Sep 17 00:00:00 2001 From: iamchenxin Date: Fri, 18 Sep 2015 02:18:19 +0800 Subject: [PATCH] Update zh-CN translation. To keep up with en docs. --- docs/02.1-jsx-in-depth.zh-CN.md | 2 +- docs/08-working-with-the-browser-zh-CN.md | 148 ++++++++++++++++++++++ 2 files changed, 149 insertions(+), 1 deletion(-) create mode 100644 docs/08-working-with-the-browser-zh-CN.md diff --git a/docs/02.1-jsx-in-depth.zh-CN.md b/docs/02.1-jsx-in-depth.zh-CN.md index 8119196a..c4442311 100644 --- a/docs/02.1-jsx-in-depth.zh-CN.md +++ b/docs/02.1-jsx-in-depth.zh-CN.md @@ -204,7 +204,7 @@ var content = React.createElement( ### 注释 -JSX 里添加注释很容易；它们只是 JS 表达式而已。你仅仅需要小心的是当你在一个标签的子节点块(props.children)时，要用 `{}` 包围要注释的部分。 +JSX 里添加注释很容易；它们只是 JS 表达式而已。你仅仅需要小心的是当你在一个标签的子节点块时，要用 `{}` 包围要注释的部分。 ```javascript var content = ( diff --git a/docs/08-working-with-the-browser-zh-CN.md b/docs/08-working-with-the-browser-zh-CN.md new file mode 100644 index 00000000..1cecd802 --- /dev/null +++ b/docs/08-working-with-the-browser-zh-CN.md @@ -0,0 +1,148 @@ +--- +id: working-with-the-browser-zh-CN +title: 与浏览器协作 +permalink: working-with-the-browser-zh-CN.html +prev: forms-zh-CN.html +next: more-about-refs-zh-CN.html +--- + +React提供了强大的抽象机制使你在大多数情况下免于直接接触DOM，但有时你仅仅只需要访问底层API，也许是为了与第三方库或者已有的代码协作。 + + +## 虚拟DOM + +React如此快速是因为它从不直接操作DOM。React维持了一个快速的内存中的DOM表示。`render()` 方法返回一个DOM的*描述*，然后React能根据内存中的描述diff此描述来计算出最快速的方法更新浏览器。 + +此外，React实现了一个完备的合成事件(synthetic event)系统，以使得所有的事件对象都被保证符合W3C细则，而不论各个浏览器的怪癖，并且所有事件跨浏览器地一致并高效的冒泡（bubbles），你甚至能在IE8里使用一些HTML5事件！ + +大多数时间你应该和React的"伪造浏览器"呆在一起，因为它更高性能并且容易推理。然而，有时你只需要访问底层API，或许是为了与第三方库比如一个jQuery插件协作。React为你提供了安全仓口来直接使用底层API。 + + +## Refs 和 findDOMNode() + +为了与浏览器互动，你需要一个指向DOM node的引用。React有一个函数`React.findDOMNode(component)` ，你能调用以得到一个指向指向组件的DOM node的引用。 + +> 注意: +> +> `findDOMNode()` 只作用于已挂载的组件（即，已经放置于DOM中的组件）。如果你尝试在还没有被挂载的组件上调用此函数（比如在`render()` 里有待被创建的组件上调用`findDOMNode()`将会抛出一个异常） + +为了获得一个指向React组件的引用，你可以要么使用`this` 来得到当前React组件，要么使用refs来引用你拥有的组件。它们像这样工作： + +```javascript +var MyComponent = React.createClass({ + handleClick: function() { + // 明确的强制text input使用原生DOM API。 + React.findDOMNode(this.refs.myTextInput).focus(); + }, + render: function() { + // 当组件被挂载时 + // ref属性给this.refs添加了一个指向指向组件的引用 + return ( +
+ + +
+ ); + } +}); + +React.render( + , + document.getElementById('example') +); +``` + + +## 更多关于Refs + +要学习更多有关refs，包括更有效使用它们的方法，请参见[more about refs](/react/docs/more-about-refs.html) 文档。 + + +## 组件的生命周期 + +组件的生命周期有三个主要部分： + +* **挂载:** 组件被注入DOM。 +* **更新:** 组件被重新渲染来决定DOM是否应被更新。 +* **卸载:** 组件从DOM中被移除。 + +React提供生命周期方法，以便你可以指定钩挂到这个过程上。我们提供了 **will** 方法，该方法在某事发生前被调用，**did**方法，在某事发生后被调用。 + + +### 挂载 + +* `getInitialState(): object` 在组件挂载前被调用. 有状态组件(Stateful components) 应该实现此函数并返回初始state的数据。 +* `componentWillMount()` 在挂载发生前被立即调用。 +* `componentDidMount()` 在挂载发生后被立即调用。 需要DOM node的初始化应该放在这里。 + + +### 更新 + +* `componentWillReceiveProps(object nextProps)` 当挂载的组件接收到新的props时被调用。此方法应该被用于比较`this.props` 和 `nextProps`以用于使用`this.setState()`执行状态转换。 +* `shouldComponentUpdate(object nextProps, object nextState): boolean` 当组件决定任何改变是否要更新到DOM时被调用。作为一个优化实现比较`this.props` 和 `nextProps` 、`this.state` 和 `nextState` ，如果React应该跳过更新，返回`false`。 +* `componentWillUpdate(object nextProps, object nextState)` 在更新发生前被立即调用。你不能在此调用`this.setState()`。 +* `componentDidUpdate(object prevProps, object prevState)` 在更新发生后被立即调用。 + + +### 卸载 + +* `componentWillUnmount()` 在组件被卸载和摧毁后被立即调用。清理应该放在这里。 + + +### Mounted Methods + +_Mounted_ 复合组件同样支持以下方法: + +* `findDOMNode(): DOMElement` 能够在任何已挂载的组件上调用以便于获取指向它渲染的DOM node的引用。 +* `forceUpdate()` 能在任何已挂载的组件上调用，当你知道一些更深层次的组件状态变化了但没有使用 `this.setState()`。 + + +## 浏览器支持和填充物(polyfills) + +在 Facebook，我们支持老浏览器，包括IE8。我们由来已久的有适当的填充物(polyfills)来让我们写前瞻性的js。这意味着我们在代码库中没有一堆散落在各处的技巧(hacks)并且我们依然能期望我们的代码"可行（just work）"。例如，我可以只写 `Date.now()`，而不是额外看到`+new Date()`。既然开源的React和我们内部使用的一样，我们也应用了这种使用前瞻性js的哲学。 + +除了这种哲学外，我们也采用了这样的立场，我们，作为一个JS库的作者，不应该把polyfills作为我们库的一部分。如果所有的库这样做，就有很大的机会发送同样的polyfill多次，这可能是一个相当大的无用代码。如果你的产品需要支援老的浏览器，你很有可能已经在使用某些东西比如[es5-shim](https://github.com/es-shims/es5-shim)。 + + +### 需要用来支持旧浏览器的Polyfills + +来自 [kriskowal's es5-shim](https://github.com/es-shims/es5-shim)的`es5-shim.js` 提供了如下React需要的东西： + +* `Array.isArray` +* `Array.prototype.every` +* `Array.prototype.forEach` +* `Array.prototype.indexOf` +* `Array.prototype.map` +* `Date.now` +* `Function.prototype.bind` +* `Object.keys` +* `String.prototype.split` +* `String.prototype.trim` + +同样来自 [kriskowal's es5-shim](https://github.com/es-shims/es5-shim)的`es5-sham.js`, 提供了如下React需要的东西： + +* `Object.create` +* `Object.freeze` + +非最小化的React build需要如下，来自[paulmillr's console-polyfill](https://github.com/paulmillr/console-polyfill). + +* `console.*` + +当在IE8里使用HTML5元素，包括`
`, `
`, `