Skip to content

forwardRef

一句话解释

forwardRef 将 ref 通过组件传递到其子组件——函数组件中 ref 转发所需。

用大白话说

forwardRef 包装组件让父组件通过它将 ref 传递给子组件。函数组件默认不接受 ref 作为 prop——forwardRef 启用它。用例:1. 转发到 DOM 元素——让父组件聚焦子组件的输入

  1. 转发到另一个组件——链式 ref 转发
  2. 与 useImperativeHandle 组合——暴露自定义方法而非 DOM 节点注意:React 19 弃用了 forwardRef——ref 将作为常规 prop 可用。但对于 React 18 及更早版本,forwardRef 是必需的。

示例

jsx
import { forwardRef, useRef } from "react";

// Without forwardRef, ref doesn't work on custom components
const MyInput = forwardRef((props, ref) => (
  <input ref={ref} className="my-input" {...props} />
));

function Form() {
  const inputRef = useRef();
  return (
    <>
      <MyInput ref={inputRef} placeholder="Type here" />
      <button onClick={() => inputRef.current.focus()}>
        Focus the input
      </button>
    </>
  );
}

forwardRef 让父组件的 ref 指向内部 <input>。没有它,ref 无法通过自定义组件到达 DOM 元素。

常见混淆

  • 容易混淆的对象: useRef

    关键区别: useRef 创建 ref 对象。forwardRef 是让组件接受 ref prop 并传递给子组件的包装器。你用 useRef 创建 ref,用 forwardRef 让它通过组件边界。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表