React Refs

React 支持一种非常特殊的属性 Ref ,你可以用来绑定到 render() 输出的任何组件上。

这个特殊的属性允许你引用 render() 返回的相应的支撑实例( backing instance )。这样就可以确保在任何时间总是拿到正确的实例。

ref 属性的值可以是一个字符串也可以是一个函数。

使用方法

绑定一个 ref 属性到 render 的返回值上:

  1. <input ref="myInput" />

在其它代码中,通过 this.refs 获取支撑实例:

  1. var input = this.refs.myInput;
  2. var inputValue = input.value;
  3. var inputRect = input.getBoundingClientRect();

完整实例

你可以通过使用 this 来获取当前 React 组件,或使用 ref 来获取组件的引用,实例如下:

  1. var MyComponent = React.createClass({
  2. handleClick: function() {
  3. // 使用原生的 DOM API 获取焦点
  4. this.refs.myInput.focus();
  5. },
  6. render: function() {
  7. // 当组件插入到 DOM 后,ref 属性添加一个组件的引用于到 this.refs
  8. return (
  9. <div>
  10. <input type="text" ref="myInput" />
  11. <input
  12. type="button"
  13. value="点我输入框获取焦点"
  14. onClick={this.handleClick}
  15. />
  16. </div>
  17. );
  18. }
  19. });
  20.  
  21. ReactDOM.render(
  22. <MyComponent />,
  23. document.getElementById('example')
  24. );

实例中,我们获取了输入框的支撑实例的引用,子点击按钮后输入框获取焦点。

我们也可以使用 getDOMNode()方法获取DOM元素