双向绑定辅助工具

ReactLink是一种简单表达React双向绑定的方式。

注意：

如果你是这个框架的初学者，记住ReactLink对于大多数应用来说都是不需要的，应该谨慎使用。

在React里面，数据流是一个方向的：从拥有者到子节点。这是因为根据the Von Neumann model of computing，数据仅向一个方向传递。你可以认为它是单向数据绑定。

然而，有很多应用需要你读取一些数据，然后传回给你的程序。例如，在开发表单的时候，当你接收到用户输入时，你将会频繁地想更新某些React state。或者你想在JavaScript中演算布局，然后反应到某些DOM元素的尺寸上。

在React中，你可以通过监听一个“change”事件来实现这个功能，从你的数据源（通常是DOM）读取，然后在你某个组件上调用setState()。"关闭数据流循环"明显会引导写出更加容易理解的和维护的程序。查看我们的表单文档来获取更多信息。

双向绑定 -- 隐式地强制在DOM里面的数据总是和某些React state保持一致 -- 是简明的，并且支持非常多的应用。我们已经提供了ReactLink：如上所述，是一种设置通用数据流循环模型的语法糖，或者说“关联”某些数据到React state。

注意：

ReactLink仅仅是一个onChange/setState()模式的简单包装和约定。它不会从根本上改变数据在你的React应用中如何流动。

ReactLink： 前后对比 #

这是一个简单的表单示例，没有使用ReactLink：

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} />;
  }
});

这段代码运行地很好，数据如何流动是非常清晰的，但是，如果表单有大量的字段，代码就会很冗长了。让我们使用ReactLink来减少打字输入：

var WithLink = React.createClass({
  mixins: [React.addons.LinkedStateMixin],
  getInitialState: function() {
    return {message: 'Hello!'};
  },
  render: function() {
    return <input type="text" valueLink={this.linkState('message')} />;
  }
});

LinkedStateMixin给你的React组件添加一个叫做linkState()的方法。linkState()返回一个ReactLink对象，包含React state当前的值和一个用来改变它的回调函数。

ReactLink对象可以在树中作为props被向上传递或者向下传递，so it's easy (and explicit) to set up two-way binding between a component deep in the hierarchy and state that lives higher in the hierarchy.

注意，对于checkbox的value属性，有一个特殊的行为，如果checkbox被选中（默认是on），value属性值将会在表单提交的时候发送出去。当checkbox被选中或者取消选中的时候，value属性是不会更新的。对于checkbox，你应该使用checkLink而不是valueLink：

<input type="checkbox" checkedLink={this.linkState('booleanValue')} />

底层原理（Under the Hood） #

对于ReactLink，有两块儿：你创建ReactLink实例的地方和你使用它的地方。为了证明ReactLink是多么的简单，让我们单独地重写每一块儿，以便显得更加明了。

不带LinkedStateMixin的ReactLink（ReactLink Without LinkedStateMixin） #

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} />;
  }
});

如你所见，ReactLink对象是非常简单的，仅仅有一个value和requestChange属性。LinkedStateMixin也同样简单：它仅占据这些字段，用来自于this.state的值和一个调用this.setState()的回调函数。（And LinkedStateMixin is similarly simple: it just populates those fields with a value from this.state and a callback that calls this.setState().）

不带valueLink的ReactLink（ReactLink Without valueLink） #

var WithoutLink = React.createClass({
  mixins: [React.addons.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} />;
  }
});

valueLink属性也很简单。它简单地处理onChange事件，然后调用this.props.valueLink.requestChange()，同时也用this.props.valueLink.value替换this.props.value。就这么简单！