前言

在 React 的函数组件中，我们通常通过 props 将数据从父组件传递给子组件，而子组件通过状态（useState）和副作用（useEffect）来管理自身的行为。然而，在某些场景下，我们希望父组件能够直接调用子组件中的某些方法或访问其内部状态。这时，useImperativeHandle 就派上了用场。

本文将深入探讨 useImperativeHandle 的用法、原理以及最佳实践，帮助你更好地掌握这一强大的 Hook。

一、什么是 useImperativeHandle？

useImperativeHandle 是 React 提供的一个 Hook，用于自定义暴露给父组件的实例值。它通常与 forwardRef 一起使用，允许父组件通过 ref 访问子组件中定义的方法或属性。

1.1 为什么需要 useImperativeHandle？

封装组件内部逻辑：允许子组件将内部方法或状态暴露给父组件，而不需要将所有细节公开。
增强组件的可复用性：通过暴露特定的 API，父组件可以更灵活地控制子组件的行为。
避免直接操作 DOM：虽然 React 鼓励声明式编程，但在某些场景下（如操作第三方库），可能需要直接操作 DOM 或组件实例。

1.2 基本语法

	import React, { useImperativeHandle, forwardRef } from 'react';const ChildComponent = forwardRef((props, ref) => {useImperativeHandle(ref, () => ({customMethod: () => {console.log('Custom method called!');},}));return <div>Child Component</div>;});function ParentComponent() {const childRef = React.useRef(null);const handleClick = () => {childRef.current?.customMethod();};	return (<div><ChildComponent ref={childRef} /><button onClick={handleClick}>Call Child Method</button></div>);}

二、useImperativeHandle 的常见用法

3.1 暴露自定义方法

这是 useImperativeHandle最常见的用法。子组件可以暴露一些方法供父组件调用。

示例：自定义输入组件

interface ChildRef {focus: () => void;getValue: () => string;
}
import React, { useImperativeHandle, useState, useRef } from "react";// 子组件
const CustomInput = ({ ref }: { ref: React.Ref<ChildRef> }) => {const [value, setValue] = useState("");const iptRef = useRef<HTMLInputElement>(null);useImperativeHandle(ref, () => ({focus: () => {iptRef.current?.focus();},getValue: () => value,}));return (<inputtype="text"value={value}onChange={(e) => setValue(e.target.value)}ref={iptRef}/>);
};// 父组件
function ParentComponent() {const inputRef = useRef<ChildRef>(null);const handleFocus = () => {inputRef.current?.focus();};// 得到子组件的输入框中的值const handleGetValue = () => {console.log("Input value:", inputRef.current?.getValue());};return (<div><CustomInput ref={inputRef} /><button onClick={handleFocus}>聚焦</button><button onClick={handleGetValue}>得到输入框值</button></div>);
}export default ParentComponent;

3.2子组件封装的弹窗关闭方法暴露给外部

我们平常会封装一些组件，但改变组件状态通常由外部组件调用，这时我们就可以暴露方法给外部

示例：

interface ChildRef {focus: () => void;getValue: () => string;close: () => void;
}
import React, { useImperativeHandle, useState, useRef } from "react";// 子组件
const CustomInput = ({ ref }: { ref: React.Ref<ChildRef> }) => {const [value, setValue] = useState("");const iptRef = useRef<HTMLInputElement>(null);// 子组件的弹窗关闭const close = () => {console.log("子组件的弹窗关闭");};useImperativeHandle(ref, () => ({focus: () => {iptRef.current?.focus();},getValue: () => value,// 暴露子组件的弹窗关闭方法close: close,}));return (<inputtype="text"value={value}onChange={(e) => setValue(e.target.value)}ref={iptRef}/>);
};// 父组件
function ParentComponent() {const inputRef = useRef<ChildRef>(null);const handleFocus = () => {inputRef.current?.focus();};const handleGetValue = () => {console.log("Input value:", inputRef.current?.getValue());};return (<div><CustomInput ref={inputRef} /><button onClick={handleFocus}>聚焦</button><button onClick={handleGetValue}>得到输入框值</button><button onClick={() => inputRef.current?.close()}>关闭弹窗</button></div>);
}export default ParentComponent;