forwardRef
一句话解释
forwardRef 将 ref 通过组件传递到其子组件——函数组件中 ref 转发所需。
用大白话说
forwardRef 包装组件让父组件通过它将 ref 传递给子组件。函数组件默认不接受 ref 作为 prop——forwardRef 启用它。用例:1. 转发到 DOM 元素——让父组件聚焦子组件的输入
- 转发到另一个组件——链式 ref 转发
- 与 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 让它通过组件边界。
相关术语
相关资源
相关课程
- React 高级
forwardRef。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。