深入理解React Refs：DOM组件、类组件实例与Ref转发机制-js教程-PHP中文网

深入理解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}">;
});

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节点）。

htmlppt.skill

把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。

下载

这意味着，通过这个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}">
    );
  }
}

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

// 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来管理组件间的数据流。