添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接
相关文章推荐
霸气的花卷  ·  关于React高阶组件 | fansueluo·  7 小时前    · 
长情的电池  ·  Ethan | 博客·  7 小时前    · 
闷骚的四季豆  ·  [ReactDoc] Forwarding ...·  7 小时前    · 
才高八斗的路灯  ·  === ...·  2 周前    · 
急躁的冰棍  ·  特斯拉 Model 3 ...·  3 月前    · 
爱玩的电影票  ·  Compile with dynamic ...·  7 月前    · 

React Refs的多种用法归纳整理

quote

Well,nobody's perfect.

Some Like It Hot

Refs 提供了一种方式,允许我们访问 DOM 节点或在 render 方法中创建的 React 元素。

我们为什么需要Refs

在典型的 React 数据流中,props 是父组件与子组件交互的唯一方式。要修改一个子组件,你需要使用新的 props 来重新渲染它。但是,在某些情况下,你需要在典型数据流之外强制修改子组件。被修改的子组件可能是一个 React 组件的实例,也可能是一个 DOM 元素。对于这两种情况,React 都提供了解决办法。

我们何时需要

下面是几个适合使用 refs 的情况:

  • 管理焦点,文本选择或媒体播放。
  • 触发强制动画。
  • 集成第三方 DOM 库。
  • 勿过度使用 Refs

    你可能首先会想到使用 refs 在你的 app 中“让事情发生”。如果是这种情况,请花一点时间,认真再考虑一下 state 属性应该被安排在哪个组件层中。通常你会想明白,让更高的组件层级拥有这个 state,是更恰当的。

    避免使用 refs 来做任何可以通过声明式实现来完成的事情。

    下面分具体的场景介绍适用的Ref方式

    不跨越层级的用法

    React.createRef()和ref属性的配合使用

  • 创建 Refs
  • class MyComponent extends React.Component {
      constructor(props) {
        super(props);
        this.myRef = React.createRef();
      render() {
        return <div ref={this.myRef} />;
    
  • 访问 Refs
  • const node = this.myRef.current;

    注意,ref 的值根据节点的类型而有所不同

  • 当 ref 属性用于 HTML 元素时,构造函数中使用 React.createRef() 创建的 ref 接收底层 DOM 元素作为其 current 属性。
  • 当 ref 属性用于自定义 class 组件时,ref 对象接收组件的挂载实例作为其 current 属性。
  • 你不能在函数组件上使用 ref 属性,因为他们没有实例。
  • 回调 Refs

    React 也支持另一种设置 refs 的方式,称为“回调 refs”。它能助你更精细地控制何时 refs 被设置和解除。

    不同于传递 createRef() 创建的 ref 属性,你会传递一个函数。这个函数中接受 React 组件实例或 HTML DOM 元素作为参数,以使它们能在其他地方被存储和访问。

    下面的例子描述了一个通用的范例:使用 ref 回调函数,在实例的属性中存储对 DOM 节点的引用。

    class CustomTextInput extends React.Component {
      constructor(props) {
        super(props);
        this.textInput = null;
        this.setTextInputRef = element => {
          this.textInput = element;
        this.focusTextInput = () => {
          // 使用原生 DOM API 使 text 输入框获得焦点
          if (this.textInput) this.textInput.focus();
      componentDidMount() {
        // 组件挂载后,让文本框自动获得焦点
        this.focusTextInput();
      render() {
        // 使用 `ref` 的回调函数将 text 输入框 DOM 节点的引用存储到 React
        // 实例上(比如 this.textInput)
        return (
            <input
              type="text"
              ref={this.setTextInputRef}
            <input
              type="button"
              value="Focus the text input"
              onClick={this.focusTextInput}
          </div>
    

    React 将在组件挂载时,会调用 ref 回调函数并传入 DOM 元素,当卸载时调用它并传入 null。在 componentDidMount 或 componentDidUpdate 触发前,React 会保证 refs 一定是最新的。

    你可以在组件间传递回调形式的 refs,就像你可以传递通过 React.createRef() 创建的对象 refs 一样。

    function CustomTextInput(props) {
      return (
          <input ref={props.inputRef} />
        </div>
    class Parent extends React.Component {
      render() {
        return (
          <CustomTextInput
            inputRef={el => this.inputElement = el}
    

    跨越层级的用法

    通过forwardRef 和 createRef的配合使用

    Ref 转发是一项将 ref 自动地通过组件传递到其一子组件的技巧。对于大多数应用中的组件来说,这通常不是必需的。但其对某些组件,尤其是可重用的组件库是很有用的。

    Ref 转发是一个可选特性,其允许某些组件接收 ref,并将其向下传递(换句话说,“转发”它)给子组件。

    普通场景使用转发refs

    在下面的示例中,FancyButton 使用 React.forwardRef 来获取传递给它的 ref,然后转发到它渲染的 DOM button:

    const FancyButton = React.forwardRef((props, ref) => (
      <button ref={ref} className="FancyButton">
        {props.children}
      </button>
    ));
    // 你可以直接获取 DOM button 的 ref:
    const ref = React.createRef();
    <FancyButton ref={ref}>Click me!</FancyButton>;
  • 在高阶组件中转发 refs 这个技巧对高阶组件(也被称为 HOC)特别有用。让我们从一个输出组件 props 到控制台的 HOC 示例开始:
  • function logProps(WrappedComponent) {
      class LogProps extends React.Component {
        componentDidUpdate(prevProps) {
          console.log('old props:', prevProps);
          console.log('new props:', this.props);
        render() {
          return <WrappedComponent {...this.props} />;
      return LogProps;
    

    “logProps” HOC 透传(pass through)所有 props 到其包裹的组件,所以渲染结果将是相同的。例如:我们可以使用该 HOC 记录所有传递到 “fancy button” 组件的 props:

    class FancyButton extends React.Component {
      focus() {
        // ...
      // ...
    // 我们导出 LogProps,而不是 FancyButton。
    // 虽然它也会渲染一个 FancyButton。
    export default logProps(FancyButton);

    上面的示例有一点需要注意:refs 将不会透传下去。这是因为 ref 不是 prop 属性。就像 key 一样,其被 React 进行了特殊处理。如果你对 HOC 添加 ref,该 ref 将引用最外层的容器组件,而不是被包裹的组件。

    这意味着用于我们 FancyButton 组件的 refs 实际上将被挂载到 LogProps 组件:

    import FancyButton from './FancyButton';
    const ref = React.createRef();
    // 我们导入的 FancyButton 组件是高阶组件(HOC)LogProps。
    // 尽管渲染结果将是一样的,
    // 但我们的 ref 将指向 LogProps 而不是内部的 FancyButton 组件!
    // 这意味着我们不能调用例如 ref.current.focus() 这样的方法
    <FancyButton
      label="Click Me"
      handleClick={handleClick}
      ref={ref}
    

    幸运的是,我们可以使用 React.forwardRef API 明确地将 refs 转发到内部的 FancyButton 组件。React.forwardRef 接受一个渲染函数,其接收 props 和 ref 参数并返回一个 React 节点。例如:

    function logProps(Component) {
      class LogProps extends React.Component {
        componentDidUpdate(prevProps) {
          console.log('old props:', prevProps);
          console.log('new props:', this.props);
        render() {
          const {forwardedRef, ...rest} = this.props;
          // 将自定义的 prop 属性 “forwardedRef” 定义为 ref
          return <Component ref={forwardedRef} {...rest} />;
      // 注意 React.forwardRef 回调的第二个参数 “ref”。
      // 我们可以将其作为常规 prop 属性传递给 LogProps,例如 “forwardedRef”
      // 然后它就可以被挂载到被 LogProps 包裹的子组件上。
      return React.forwardRef((props, ref) => {
        return <LogProps {...props} forwardedRef={ref} />;
      });
    

    将ref的值作为组件的属性往下传递到目标节点或者实例。

  • 传递createRef
  • const myRef= React.createRef();
    class Child extends React.Component {
      render() {
        const {refInfo} = this.props;
        return (
          <div ref={refInfo}>Hello world</div>
    class App extends React.Component{
      componentDidMount() {
        myRef && console.log("=========>>>", myRef);
      render() {
        return <Child refInfo={myRef}/>
    ReactDOM.render(<App/>, document.getElementById("root"));
  • 传递ref回调
  • function CustomTextInput(props) {
      return (
          <input ref={props.inputRef} />
        </div>
    class Parent extends React.Component {
      render() {
        return (