{"parents":["f1c15444019587783d1afd181c8cc15ea3b04ff2","209b7522d99a8af36f8d9e06ce622c59b793e5a3"],"body":"Update zh-docs with 4865ddf(v0.14.3+)","commit":{"subject":"Merge pull request #5724 from iamchenxin\/docs122315","authorEmail":"paul@oshannessy.com","authorName":"Paul O’Shannessy","authoredAt":"2016-01-15T11:18:35-08:00","revision":"909cba225461a14bad100717819f54326f77f38a","shortRevision":"909cba2254"},"files":[{"status":"M","path":".gitignore"},{"status":"A","path":"docs\/docs\/10.10-shallow-compare.zh-CN.md"},{"status":"A","path":"docs\/docs\/10.2-form-input-binding-sugar.zh-CN.md"},{"status":"A","path":"docs\/docs\/10.3-class-name-manipulation.zh-CN.md"},{"status":"A","path":"docs\/docs\/12-context.zh-CN.md"},{"status":"A","path":"docs\/docs\/conferences.zh-CN.md"},{"status":"M","path":"docs\/docs\/getting-started.zh-CN.md"},{"status":"M","path":"docs\/docs\/ref-01-top-level-api.zh-CN.md"},{"status":"M","path":"docs\/docs\/ref-02-component-api.zh-CN.md"},{"status":"A","path":"docs\/docs\/ref-03-component-specs.zh-CN.md"},{"status":"A","path":"docs\/docs\/ref-04-tags-and-attributes.zh-CN.md"},{"status":"M","path":"docs\/docs\/ref-05-events.zh-CN.md"},{"status":"A","path":"docs\/docs\/ref-06-dom-differences.zh-CN.md"},{"status":"A","path":"docs\/docs\/ref-07-special-non-dom-attributes.zh-CN.md"},{"status":"A","path":"docs\/docs\/ref-10-glossary.zh-CN.md"},{"status":"A","path":"docs\/docs\/videos.zh-CN.md"}],"patch":"diff --git a\/.gitignore b\/.gitignore\nindex 927b40333d..348b88dc41 100644\n--- a\/.gitignore\n+++ b\/.gitignore\n@@ -25,3 +25,4 @@ chrome-user-data\n *.sublime-workspace\n .idea\n *.iml\n+.vscode\ndiff --git a\/docs\/docs\/10.10-shallow-compare.zh-CN.md b\/docs\/docs\/10.10-shallow-compare.zh-CN.md\nnew file mode 100644\nindex 0000000000..6ed9a161bb\n--- \/dev\/null\n+++ b\/docs\/docs\/10.10-shallow-compare.zh-CN.md\n@@ -0,0 +1,32 @@\n+---\n+id: shallow-compare-zh-CN\n+title: 浅比较\n+permalink: shallow-compare-zh-CN.html\n+prev: perf-zh-CN.html\n+next: advanced-performance-zh-CN.html\n+---\n+\n+`shallowCompare` 是一个辅助函数在以ES6类使用React时，完成和 `PureRenderMixin` 相同的功能。\n+\n+如果你的React组件的绘制函数是 “干净的” （换句话说，它在给定的 props 和 state 下绘制相同的结果）,你可以使用这个辅助函数以在某些情况下提升性能。\n+\n+例如:\n+\n+```js\n+var shallowCompare = require('react-addons-shallow-compare');\n+export class SampleComponent extends React.Component {\n+ shouldComponentUpdate(nextProps, nextState) {\n+ return shallowCompare(this, nextProps, nextState);\n+ }\n+\n+ render() {\n+ return

foo<\/div>;\n+ }\n+}\n+```\n+\n+`shallowCompare` 对当前的 `props` 和 `nextProps`对象执行一个浅的相等检查，同样对于 `state` 和 `nextState`对象。\n+它通过迭代比较对象的keys 并在对象的key值不严格相等时返回false 实现此功能.\n+\n+`shallowCompare` 返回 `true` 如果对 props 或 state的浅比较失败，因此组件应该更新。\n+`shallowCompare` 返回 `false` 如果对 props 或 state的浅比较都通过了，因此组件不应该更新。\ndiff --git a\/docs\/docs\/10.2-form-input-binding-sugar.zh-CN.md b\/docs\/docs\/10.2-form-input-binding-sugar.zh-CN.md\nnew file mode 100644\nindex 0000000000..2828415187\n--- \/dev\/null\n+++ b\/docs\/docs\/10.2-form-input-binding-sugar.zh-CN.md\n@@ -0,0 +1,117 @@\n+---\n+id: two-way-binding-helpers-zh-CN\n+title: 双向绑定辅助\n+permalink: two-way-binding-helpers-zh-CN.html\n+prev: animation-zh-CN.html\n+next: test-utils-zh-CN.html\n+---\n+\n+`ReactLink` 是一个用React表达双向绑定的简单方法。\n+\n+> 注意：\n+>\n+> 如果你刚学这个框架，注意 `ReactLink` 对大多数应用是不需要的，应该慎重的使用。\n+\n+在React里，数据单向流动：从拥有者到子级。这是因为数据只单向流动[the Von Neumann model of computing](https:\/\/en.wikipedia.org\/wiki\/Von_Neumann_architecture)。你可以把它想象为 “单向数据绑定”。\n+\n+然而，有很多应用需要你去读某些数据并回流他们到你的程序。例如，当开发forms，你会常常想更新一些React `state` 当你收到用户输入的时候。或者也许你想在JavaScript完成布局并相应一些DOM元素大小的变化。\n+\n+在React里，你可以用监听 \"change\" 事件来实现它，从你的数据源（通常是DOM）读取并在你的某个组件调用 `setState()` 。明确的\"Closing the data flow loop\" 致使了更容易理解和维护的程序。更多信息见[our forms documentation](\/react\/docs\/forms.html).\n+\n+双向绑定 -- 隐含的强迫DOM里的某些值总是和某些React `state` 同步 -- 简洁并支持大量多样的应用。我们提供了 `ReactLink`：设置如上描述的通用数据回流模式的语法糖，或者 \"linking\" 某些数据结构到 React `state`.\n+\n+> 注意:\n+>\n+> `ReactLink` 只是一层对 `onChange`\/`setState()` 模式的薄包装。它没有根本性的改变你的React应用里数据如何流动。\n+\n+## ReactLink: 之前和之后\n+\n+这里有一个简单的不用 `ReactLink` 的 form 例子：\n+\n+```javascript\n+var NoLink = React.createClass({\n+ getInitialState: function() {\n+ return {message: 'Hello!'};\n+ },\n+ handleChange: function(event) {\n+ this.setState({message: event.target.value});\n+ },\n+ render: function() {\n+ var message = this.state.message;\n+ return ;\n+ }\n+});\n+```\n+\n+这个工作的很好并且数据如何流动很清晰，然而，当有大量的 form fields时，可能会有些冗长。让我们使用 `ReactLink` 来节省我们的输入：\n+\n+```javascript{4,9}\n+var LinkedStateMixin = require('react-addons-linked-state-mixin');\n+\n+var WithLink = React.createClass({\n+ mixins: [LinkedStateMixin],\n+ getInitialState: function() {\n+ return {message: 'Hello!'};\n+ },\n+ render: function() {\n+ return ;\n+ }\n+});\n+```\n+\n+`LinkedStateMixin` 添加了一个 `linkState()` 方法到你的React组件。`linkState()` 返回一个 `ReactLink` 包含当前React state值的对象和一个改变它的回调函数。\n+\n+`ReactLink` 对象可以作为props在树中上下传递，所以很容易（显示的）在深层次的组件和高层次的state之间设置双向绑定。\n+\n+注意 checkboxes 有一个关于他们 `value` 属性的特殊行为，这个行为是如果checkbox被选中值会在表单提交时被发送。 `value` 不会 checkbox 选中或是不选中时更新。对于checkboxes，你应该用`checkedLink` 代替 `valueLink`:\n+```\n+\n+```\n+\n+## 引擎盖下\n+\n+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.\n+\n+### ReactLink Without LinkedStateMixin\n+\n+```javascript{5-7,9-12}\n+var WithoutMixin = React.createClass({\n+ getInitialState: function() {\n+ return {message: 'Hello!'};\n+ },\n+ handleChange: function(newValue) {\n+ this.setState({message: newValue});\n+ },\n+ render: function() {\n+ var valueLink = {\n+ value: this.state.message,\n+ requestChange: this.handleChange\n+ };\n+ return ;\n+ }\n+});\n+```\n+\n+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()`.\n+\n+### ReactLink Without valueLink\n+\n+```javascript\n+var LinkedStateMixin = require('react-addons-linked-state-mixin');\n+\n+var WithoutLink = React.createClass({\n+ mixins: [LinkedStateMixin],\n+ getInitialState: function() {\n+ return {message: 'Hello!'};\n+ },\n+ render: function() {\n+ var valueLink = this.linkState('message');\n+ var handleChange = function(e) {\n+ valueLink.requestChange(e.target.value);\n+ };\n+ return ;\n+ }\n+});\n+```\n+\n+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!\ndiff --git a\/docs\/docs\/10.3-class-name-manipulation.zh-CN.md b\/docs\/docs\/10.3-class-name-manipulation.zh-CN.md\nnew file mode 100644\nindex 0000000000..48b38d9090\n--- \/dev\/null\n+++ b\/docs\/docs\/10.3-class-name-manipulation.zh-CN.md\n@@ -0,0 +1,11 @@\n+---\n+id: class-name-manipulation-zh-CN\n+title: 类名操纵\n+permalink: class-name-manipulation-zh-CN.html\n+prev: two-way-binding-helpers-zh-CN.html\n+next: test-utils-zh-CN.html\n+---\n+\n+> NOTE:\n+>\n+> 此模块已被弃用; 用 [JedWatson\/classnames](https:\/\/github.com\/JedWatson\/classnames) 替代.\ndiff --git a\/docs\/docs\/12-context.zh-CN.md b\/docs\/docs\/12-context.zh-CN.md\nnew file mode 100644\nindex 0000000000..c6da13bad6\n--- \/dev\/null\n+++ b\/docs\/docs\/12-context.zh-CN.md\n@@ -0,0 +1,173 @@\n+---\n+id: context-zh-CN\n+title: Context\n+permalink: context-zh-CN.html\n+prev: advanced-performance-zh-CN.html\n+---\n+\n+React最大的优势之一是他很容易从你的React组件里跟踪数据流动。当你看着一个组件，你可以很容易准确看出哪个props被传入，这让你的APP很容易推断。\n+\n+偶尔，你想通过组件树传递数据，而不在每一级上手工下传prop，React的 \"context\" 让你做到这点。\n+\n+＞　注意：\n+＞　\n+＞　Context是一个先进的实验性特性．这个 API 很可能在未来版本变化.\n+>\n+> 大多数应用将不会需要用到 context. 尤其是如果你刚开始用React,你很可能不会想用 context.使用 context 将会使你的代码很难理解因为它让数据流不清晰.它类似于在你的应用里使用全局变量传递state.\n+>\n+> **如果你必须使用 context ,保守的使用它**\n+>\n+> 不论你正在创建一个应用或者是库,试着分离你对 context 的使用到一个小区域,并尽可能避免直接使用 context API,以便在API变动时容易升级.\n+\n+## 从树里自动传递info\n+\n+假设你有一个这样的结构:\n+\n+```javascript\n+var Button = React.createClass({\n+ render: function() {\n+ return (\n+

dillon1000/react

Files changed