深入理解React Refs：DOM组件、类组件实例与Ref转发机制

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

深入理解React Refs：DOM组件、类组件实例与Ref转发机制

2025-10-11

浏览次数：次

返回列表

深入理解React Refs：DOM组件、类组件实例与Ref转发机制

本文旨在深入探讨react中refs的工作机制，特别是“dom组件”在refs语境下的确切含义，以及ref转发（ref forwarding）如何应用于原生dom元素和自定义类组件实例。我们将澄清react官方文档中关于ref转发的表述，并通过示例代码展示如何正确地将refs转发至类组件实例，从而帮助开发者更好地理解和应用这一高级特性。

理解React中的Refs

在React中，Refs提供了一种访问在渲染方法中创建的DOM节点或React组件实例的方式。它们通常用于需要直接与底层DOM节点交互的场景，例如管理焦点、文本选择、媒体播放，或者触发命令式动画。

“DOM组件”在Refs语境下的含义

在React文档中，当提及“DOM组件”时，它通常指的是原生HTML元素，例如

Ref转发（Ref Forwarding）机制

Ref转发是React提供的一种技术，允许组件将它收到的Ref向下传递给它的某个子组件，甚至是该子组件内部的原生DOM节点。这在创建可复用组件库时非常有用，因为它允许父组件直接访问子组件内部的DOM节点或组件实例，而无需通过props层层传递回调函数。

React.forwardRef是一个高阶组件，它接收一个渲染函数作为参数。这个渲染函数有两个参数：props和ref。

const MyForwardedComponent = React.forwardRef((props, ref) => {
  // 在这里可以使用ref
  return <input ref={ref} {...props} />;
});

Ref转发至原生DOM元素

当Ref转发的目标是原生DOM元素时，ref参数将直接被传递并附加到该DOM元素上。这是最常见的Ref转发场景，例如创建一个自定义的输入框组件，但仍然允许外部直接访问其内部的 DOM节点。

import React from 'react';

// 一个自定义的FancyButton组件，它将接收到的ref转发给内部的button元素
const FancyButton = React.forwardRef((props, ref) => (
  <button ref={ref} className="FancyButton" onClick={props.onClick}>
    {props.children}
  </button>
));

function App() {
  const buttonRef = React.useRef(null);

  const handleClick = () => {
    if (buttonRef.current) {
      buttonRef.current.focus(); // 聚焦到底层button DOM元素
      console.log('Button clicked!');
    }
  };

  return (
    <div>
      <FancyButton ref={buttonRef} onClick={handleClick}>
        聚焦并点击
      </FancyButton>
    </div>
  );
}

export default App;

在这个例子中，buttonRef.current将指向FancyButton组件内部渲染的

Ref转发至类组件实例

React文档中的一个关键点是：“Ref转发不限于DOM组件。你也可以将Refs转发到类组件实例。”这句表述强调了Ref转发的灵活性。当Ref转发的目标是一个自定义的类组件时，传递的ref将指向该类组件的实例，而不是其内部渲染的DOM节点（除非该类组件本身将Ref进一步转发给了其内部的DOM节点）。

Delphi 7应用编程150例全书内容 CHM版

Delphi 7应用编程150例 CHM全书内容下载，全书主要通过150个实例，全面、深入地介绍了用Delphi 7开发应用程序的常用方法和技巧，主要讲解了用Delphi 7进行界面效果处理、图像处理、图形与多媒体开发、系统功能控制、文件处理、网络与数据库开发，以及组件应用等内容。这些实例简单实用、典型性强、功能突出，很多实例使用的技术稍加扩展可以解决同类问题。使用本书最好的方法是通过学习掌握实例中的技术或技巧，然后使用这些技术尝试实现更复杂的功能并应用到更多方面。本书主要针对具有一定Delphi基础知识

1 查看详情 Delphi 7应用编程150例全书内容 CHM版

这意味着，通过这个Ref，你可以访问类组件实例上的所有方法和属性，例如调用其内部的方法或访问其状态（尽管直接访问组件内部状态通常不推荐）。

为了实现这一点，类组件需要通过props接收这个转发的Ref。通常，我们会将这个Ref命名为innerRef或其他自定义名称，以避免与React内部的ref属性混淆。

以下是一个将Ref转发至类组件实例的示例：

import React from 'react';

// 1. 定义一个类组件
class ClassComponent extends React.Component {
  // 假设这个类组件有一个内部方法
  focusInput() {
    if (this.props.innerRef && this.props.innerRef.current) {
      this.props.innerRef.current.focus();
    }
    console.log('ClassComponent method called!');
  }

  render() {
    // 将接收到的innerRef prop附加到内部的input元素上
    return (
      <input
        value={this.props.value}
        onChange={this.props.onChange}
        placeholder={this.props.placeholder}
        ref={this.props.innerRef} // 这里将外部转发的ref附加到内部input
      />
    );
  }
}

// 2. 使用React.forwardRef将ref转发到ClassComponent
// forwardRef的渲染函数接收props和ref
const Input = React.forwardRef(function (props, ref) {
  // 将外部传入的ref作为innerRef prop传递给ClassComponent
  return <ClassComponent {...props} innerRef={ref} />;
});

// 3. 在父组件中使用转发的Ref
function App() {
  const inputRef = React.useRef(null); // 这个ref将指向ClassComponent的实例

  React.useEffect(() => {
    if (inputRef.current) {
      // 通过ref访问ClassComponent的实例，并调用其方法
      inputRef.current.focusInput(); 
    }
  }, []);

  return (
    <div>
      <Input ref={inputRef} placeholder="请输入内容" />
    </div>
  );
}

export default App;

在这个例子中：

App组件创建了一个inputRef。
Input组件（通过React.forwardRef创建）接收这个inputRef作为其ref参数。
Input组件将这个ref作为innerRef prop传递给ClassComponent。
ClassComponent在其render方法中，将this.props.innerRef附加到其内部的元素上。
最终，inputRef.current将指向ClassComponent的实例。通过这个实例，我们就可以调用ClassComponent内部定义的focusInput方法。

关键点：

当Ref转发给一个类组件时，你通过ref.current获得的是该类组件的实例。
当Ref转发给一个函数组件时（且该函数组件内部没有使用useImperativeHandle），ref.current通常指向该函数组件内部渲染的DOM节点。

总结与注意事项

“DOM组件”的含义：在React Ref语境中，通常指原生HTML元素（如
Ref转发的目的：允许父组件访问子组件内部的DOM节点或组件实例，实现更灵活的组件交互。
Ref转发至原生DOM元素：ref.current将直接指向目标DOM节点。
Ref转发至类组件实例：ref.current将指向目标类组件的实例。这意味着你可以访问该实例上的公共方法和属性。类组件需要通过props（例如innerRef）来接收和使用这个转发的Ref。
Ref转发至函数组件：默认情况下，Ref不能直接附加到函数组件上。需要配合React.forwardRef和（可选的）useImperativeHandle来暴露特定的值或DOM节点。如果函数组件只是将Ref转发给其内部的DOM节点，那么ref.current将指向该DOM节点。
避免过度使用Refs：Refs主要用于命令式操作，应尽量避免在声明式UI流程中滥用Refs。优先使用props和state来管理组件间的数据流。