{"patch":"diff --git a\/docs\/docs\/08.1-more-about-ref-zh-CN.md b\/docs\/docs\/08.1-more-about-ref-zh-CN.md\nnew file mode 100644\nindex 0000000000..69f1fa21c1\n--- \/dev\/null\n+++ b\/docs\/docs\/08.1-more-about-ref-zh-CN.md\n@@ -0,0 +1,174 @@\n+---\n+id: more-about-refs\n+title: Refs 的更多信息\n+permalink: more-about-refs-zh-CN.html\n+prev: working-with-the-browser-zh-CN.html\n+next: tooling-integration-zh-CN.html\n+---\n+在从render方法返回你的UI结构之前，你可能想向从`render()` 返回的组件的实例“伸手”并调用其上的方法。通常，做类似这样的事情没必要在你的引用中制造数据流，因为Reactive的数据量确保最近的`props` 被发送到从 `render()` 返回的每个孩子中。然而，有些情况，这样做还是必须的或者有帮助的。\n+\n+考虑一下情形，元素`` (他存在于你的子层级中),当你更新它的值为一个空的字符串`''` 的时候，你告诉它获得焦点。\n+\n+```javascript\n+ var App = React.createClass({\n+ getInitialState: function() {\n+ return {userInput: ''};\n+ },\n+ handleChange: function(e) {\n+ this.setState({userInput: e.target.value});\n+ },\n+ clearAndFocusInput: function() {\n+ this.setState({userInput: ''}); \/\/清空输入\n+ \/\/ 现在我们希望获取焦点!\n+ },\n+ render: function() {\n+ return (\n+

\n+

\n+ Click to Focus and Reset\n+ <\/div>\n+ \n+ <\/div>\n+ );\n+ }\n+ });\n+```\n+\n+在这个例子中，注意我们是如何想要“告诉” input 一些事情的- 一些不能从它的props得到的东西。在这种情形下，我们想要“告诉”它，它现在也要改获取焦点了。然而，这里有些挑战。从`render()` 中返回的不是你实际组件的“孩子”组件，相反他是这些孩子在特定的时刻的一个*描述* - 一个快照。\n+\n+> 注意:\n+>\n+>记着，从`render()` 中返回的不是你的*实际*渲染地孩子实例。从`render()` 中返回的仅仅是在你的组件的子层次结构中的这些孩子实例一个特定时刻的*描述*。\n+\n+\n+这意味着你绝不该“拿”从`render()` 中返回的东西去做什么事情并期望有什么意义。\n+\n+```javascript\n+ \/\/ 反模式:不能工作.\n+ render: function() {\n+ var myInput = ; \/\/ 我打算在这个上调用这个方法 \n+ this.rememberThisInput = myInput; \/\/ input在未来的某个时间点上！YAY!\n+ return (\n+

\n+

...<\/div>\n+ {myInput}\n+ <\/div>\n+ );\n+ }\n+```\n+\n+在这个例子中，`` 仅仅是 `` 的一个*描述*。这个描述不能用来为``创建一个*真实的* **背后的实例**。\n+\n+那么对 input 的*真实的* 背后的实例，该怎么说呢？\n+\n+## ref 字符串属性\n+\n+React 假设你可以向任何的从`render()` 中返回的组件附加一个特别的属性。这个特殊的属性允许你引用任何的从`render()` 返回的东西对于有的**背后的实例**。而且保证在任何时间点都是合适的实例。\n+\n+简单的说就是：\n+\n+\n+1. 给任何从`render()` 中返回的东西赋一个`ref` 的属性，如下所示：\n+\n+ ```html\n+ \n+ ```\n+\n+2. 在其他的代码中（通常是事件处理代码中），通过 `this.refs` 来访问 **背后的实例** 如下所示:\n+\n+ ```javascript\n+ this.refs.myInput\n+ ```\n+\n+通过调用`React.findDOMNode(this.refs.myInput)` 你可以直接方法这个组建的DOM。\n+\n+\n+## ref 回调属性\n+\n+`ref` 属性可以用一个回调函数来替换一个名字。当这个组件装载好之后立即执行。被引用的组件被作为一个参数传入，这个回调函数可能立即使用这个组件，或保存这个引用，将来再用（或者两者都做）。\n+\n+使用ES6的箭头函数，为从`render` 中返回的东西添加一个`ref` 属性非常简单:\n+\n+```html\n+ render: function() {\n+ return this._input = c} \/>;\n+ },\n+ componentDidMount: function() {\n+ this._input.focus();\n+ },\n+```\n+\n+或\n+\n+```html\n+ render: function() {\n+ return (\n+ \n+ );\n+ },\n+```\n+\n+注意当引用的组件被卸载以及无论何时这个引用改变之后，旧的引用将会被用`null` 作为一个参数来调用。这避免了当实例被存储的情形下- 像第一个例子那样 - 引起的内存泄漏。注意像这个例子中这样，用inline 函数表达式写引用的时候，每次有更新的时候Reac看到的都是不同的函数对象，在引用被组件的实例调用之前，引用被用`null` 调用。\n+\n+## 完整的例子\n+\n+```javascript\n+ var App = React.createClass({\n+ getInitialState: function() {\n+ return {userInput: ''};\n+ },\n+ handleChange: function(e) {\n+ this.setState({userInput: e.target.value});\n+ },\n+ clearAndFocusInput: function() {\n+ \/\/ 清空input\n+ this.setState({userInput: ''}, function() {\n+ \/\/ 当这个组件被再次渲染之后，这个代码执行\n+ React.findDOMNode(this.refs.theInput).focus(); \/\/获取焦点了！\n+ });\n+ },\n+ render: function() {\n+ return (\n+

\n+

\n+ Click to Focus and Reset\n+ <\/div>\n+ \n+ <\/div>\n+ );\n+ }\n+ });\n+```\n+\n+在这个例子中，我们的render函数返回了`` 实例的一个描述。但是真的实例通过`this.refs.theInput` 访问。只要`ref=\"theInput\"` 从`render` 中返回了, `this.refs.theInput` 就可以访问合适的实例。这个事件对于高级的（非DOM)的组件，例如`` 也适用的。\n+\n+\n+## 总结\n+\n+在不方便通过Reactive的 `props` 和`state` 流的方式传递信息的时候，Refs是给一个特殊的子实例发送消息的重要的方法。然而，他们不应该成为你的应用程序的到哪里去的数据流的抽象。对于那些本质上来说非交互的情形来说，默认的，应该使用Reactive数据流而少用`ref` 。\n+\n+### 优点:\n+\n+- 在你的组件类中你可以定义任意的公开方法（例如在一个Typeahead定义一个reset方法），然后通过refs来调用这些方法（像这样`this.refs.myTypeahead.reset()`)。\n+\n+- 执行 DOM操作，总是要求诸如`` 这样的一个“原生”组件，并通过`React.findDOMNode(this.refs.myInput)` 来访问她的低层的MOD 节点。Refs是可以做成这个事的唯一的实践可行的方法。\n+\n+- Refs自动管理！如果孩子被销毁了，它的ref也被销毁。在这里不用担心内存（除非你做了一些疯狂的事情来自己保持一个引用）。 \n+\n+### 小心:\n+\n+- *绝对不要* 在组件的render方法内部- 获当任何组件的render方法还在调用栈中执行的时候，访问refs 。 \n+- 如果你想要保护Google 闭包编译器崩溃的内力，确保绝不作为访问一个被特别的设置为一个字符串的属性。这就意味着，如果你用`ref=\"myRefString\"` 来定义你的ref的话，你必须使用`this.refs['myRefsString']` 来访问。\n+- 如果你不是用React做服务器编程的，在你的程序中，你首先的倾向是用refs来“让事情发生“。如果这是正是你的情况的话，花点时间，仔细的想想`state` 在这个组件的结构层次中应在在哪里使用。通常，正确的\"拥有\" 状态的地方是结构层次的高层。把状态放在那些地方通常可以消除使用`ref` 来”让事情发生” 的渴望 - 相反的，数据流通常能完成你的目标。\n\\ No newline at end of file\n","body":"Translation 08.1-more-about-ref.md to Chinese","parents":["8854a31e31f90dfba824b0c0924cb2aba05e9e2b","1dbde787d004b01b342ebdfe4f9196de523d0a35"],"commit":{"revision":"3936e3fddbe3740c4911ab835d8062010f8a8b0f","authorName":"Jim","authorEmail":"jsproch@fb.com","shortRevision":"3936e3fddb","authoredAt":"2015-09-25T11:33:36-07:00","subject":"Merge pull request #4967 from zhangjg\/zhangjg-br"},"files":[{"path":"docs\/docs\/08.1-more-about-ref-zh-CN.md","status":"A"}]}

dillon1000/react

Files changed