Skip to content
Linbudu's Blog

从一个需求出发,聊聊useRef三兄弟

1 min read

前言

Vue、React、Angular这一类前端框架的出现使得我们不再需要去手动操作Dom了,回想曾经的JQuery时代,与DOM打交道是最为频繁也最为头疼的,比如我前端入门时期收获最多的书之一就是JavaScript DOM编程艺术

现在我们和DOM直接打交道的机会少的多了,但在部分场景下仍然不可避免,比如输入框的聚焦、滚动、文本选择以及动画等场景。在Vue中,我们有ref$refs,在React中我们有refcreateRef以及本文的useRef三兄弟(指useRefforwardRef以及useImperativeHandle),来使得我们能够在某些无法避免的场景下方便的操作dom。

以下内容的阅读需要你了解useRef三兄弟,如果你此前没有了解过,可以直接跳到正文第一部分,我会依次讲解useRef三兄弟的使用。

会想写这篇文章不是因为useRef三兄弟有多么重要,实际上大部分前端同学很少会使用到它。而是我遇到的这个场景让我意识到了useRef在除了DOM以外的场景能起到特殊的作用:

我之前的实习期间负责的一个函数配置平台,FaaS函数需要在这个平台完成一系列配置(具体包含哪些配置项就不说了),这些配置被我分割成多个独立组件,每一个组件能够负责自己的数据。但某一天来了个比较大的变更需求,现在需要允许其他用户(阿里的其他BU)自己编写配置组件,并且能够无缝接入到整体配置中。简单地说,现在我要在用户完成配置后,收集到用户编写组件透出的数据,并完成统一的提交

具体其中的思路以及方案比对就直接略过,最后我给出的方案大概是这样的:

  • 提供一个脚手架,封装开发规范,用户自定义组件需要使用脚手架开发并发布到内部npm源
  • 开发规范包括必须实现两个方法:数据收集collect与数据校验validate方法,前者在调用时返回组件内的配置信息与元数据,后者对组件配置进行校验后返回校验状态
  • 在配置完成时,主组件会获取到所有自定义子组件的校验状态(validate方法)以及数据(collect方法),在完成校验后,将子组件数据统一合入状态树进行保存。

看起来很简单,但有这么几个问题:

父组件如何获取到子组件方法:

  • 很简单,用useRef三兄弟,将子组件的方法暴露出去,父组件通过ref进行调用,如ref.current.validate()

待配置的函数项(每一个函数都需要依次进行配置)与用户配置中存在的自定义配置项都是不确定的,由于hooks的原则(不要在循环中使用hooks),我们不能根据函数以及配置项数量动态的调用useRef生成ref:

  • 那就用一个ref就行,所有的方法都挂载到这个ref上

ref在多次写入的情况下,上面的current属性会被覆盖,即使是不同的键名:

  • 自己封装一个hook,允许每次写入current时进行值的合并

好了,结束,全文完

我把最后一步封装的hook称为useMultiImperativeHandle,名字很长,但实际上非常简单,因为它实际上就是对useImperativeHandle的增强,底层也是基于其实现。在最后一部分,我会介绍它的思路与实际使用,如果你对useRef相关已经比较了解,可以直接查看 useMultiImperativeHandle源码 (真的很简单)

建议使用我写的 Parcel-Tsx-Template 来跑本文中的demo,比Webpack以及Create-React-App轻便的多,并且足够handle常见中小项目了。

useRef

在React的Class组件时期,我们通过createRef创建ref,看看官网的示例:

1class MyComponent extends React.Component {
2 constructor(props) {
3 super(props);
4
5 this.inputRef = React.createRef();
6 }
7
8 render() {
9 return <input type="text" ref={this.inputRef} />;
10 }
11
12 componentDidMount() {
13 this.inputRef.current.focus();
14 }
15}

在这个例子里ref被分配给了原生DOM元素<input />,在这种情况下可以通过ref.current获取到这个DOM元素,并直接调用上面的方法。ref也可以被分配给一个Class组件,这样ref.current获取到的就是这个Class组件的实例。

但是,ref不能被分配给一个函数式组件(除非使用forwardRef,详见下一部分),因为函数式组件没有实例

在函数式组件中,我们这样使用ref(注意,“在函数组件中使用ref” !== “将ref分配给函数式组件”)

1function TextInputWithFocusButton() {
2 const inputEl = useRef(null);
3 const onButtonClick = () => {
4 inputEl.current.focus();
5 };
6 return (
7 <>
8 <input ref={inputEl} type="text" />
9 <button onClick={onButtonClick}>Focus the input</button>
10 </>
11 );
12}

createRefuseRef的重要区别是createRef不能用在函数式组件中,而useRef不能用在Class组件中,前者的不能指的是 在函数式组件中使用createRef创建的ref,其值会随着函数式组件的重新执行而不断初始化,而后者的不能就比较简单了,hooks不能用在Class组件嘛。

useRef实际上还有一些奇技淫巧,由于它能够在组件的整个生命周期内保存current上的值,因此经常被用来解决一些闭包(参考Dan写的这篇文章)与计时器问题,比如阿里开源的React Hooks库 ahooks 中就大量使用了useRef来保存计时器,我之前写的一个自定义hooks useVerifyCode 也是。

这个hooks设计的场景是面向前端常见的验证码场景,如点击发送短信-禁用按钮60秒-恢复按钮点击。

还有官方给的这个自定义hookusePrevious

1function usePrevious(value) {
2 const ref = useRef();
3 useEffect(() => {
4 ref.current = value;
5 });
6 return ref.current;
7}

这个hooks可以拿到上一次的值,原理是useEffect会在每次渲染完毕后执行,所以ref的值在本次渲染过程永远会停留在上一次。

forwardRef

前面我们说,ref不能被分配给函数式组件(无论这个ref是通过哪种方式创建的),准确的说应该是:ref不能被分配给没有给forwardRefd包裹的函数式组件

forwardRef的使用是这样的:

1const App: React.FC = () => {
2 const ref = useRef() as MutableRefObject<any>;
3
4 useEffect(() => {
5 ref.current.focus();
6 }, []);
7
8 return (
9 <>
10 <Child ref={ref} />
11 </>
12 );
13};
14
15const Child = forwardRef((props, ref: Ref<any>) => {
16 return <input type="text" name="child" ref={ref} />;
17});

由于这里类型不是重点,所以我就直接any了

forwardRef可以直接包裹一个函数式组件,被包裹的函数式组件会获得被分配给自己的ref(作为第二个参数)。

如果你直接将ref分配给没有被forwardRef包裹的函数式组件,React会在控制台给出错误。

forwardRef的另一种使用场景是 高阶组件中转发refs, 由于HOC的使用越来越少,这里就不做展开,有兴趣的同学可以查看链接。

forwardRef通常是和useImperativeHandle一起使用,如果说forwardRef使得函数式组件拥有了让别人一窥芳容的能力,useImperativeHandle则就是她脸上的面纱:她可以随心所欲决定想让你看到什么。

useImperativeHandle

forwardRef例子中的代码实际上是不推荐的,因为无法控制要暴露给父组件的值,所以我们使用useImperativeHandle控制要将哪些东西暴露给父组件:

先来看看@types/react中的调用签名:

1function useImperativeHandle<T, R extends T>(ref: Ref<T>|undefined, init: () => R, deps?: DependencyList): void;

从这个签名我们大概能get到调用方式:

  • 接收一个ref
  • 接收一个函数,这个函数返回的对象即是要暴露出的ref
  • 类似useEffect,接收一个依赖数组
1onst App: React.FC = () => {
2 const ref = useRef() as MutableRefObject<any>;
3
4 useEffect(() => {
5 ref.current.input.focus();
6 }, []);
7
8 return (
9 <>
10 <Child ref={ref} />
11 </>
12 );
13};
14
15const Child = forwardRef((props, ref: Ref<any>) => {
16 const inputRef1 = useRef() as MutableRefObject<HTMLInputElement>;
17 const inputRef2 = useRef() as MutableRefObject<HTMLInputElement>;
18
19 useImperativeHandle(
20 ref,
21 () => {
22 return {
23 input: inputRef1.current,
24 };
25 },
26 [inputRef1]
27 );
28
29 return (
30 <>
31 <input type="text" name="child1" ref={inputRef1} />
32 <br />
33 <input type="text" name="child2" ref={inputRef2} />
34 </>
35 );
36});

在这个例子中,我们在Child组件内再次创建了两个ref,但我们只想暴露出第一个,因此使用useImperativeHandle来进行了控制。

现在我们可以理解了:useImperativeHandle的第一个参数表示你要操作的ref,第二个参数的返回值则是你要挂载在这个refcurrent属性上的值。你可以理解为一根垂直管道,你在上方投入了什么,下方拿到的就是什么。最后一个参数则是在inputRef1变化时更新这个挂载。

单纯的useRef不会在挂载对象时进行通知,如果有这个需求,需要使用callback ref

useRef不一定要用来保存DOM或者Class组件,还可以用来保存计时器或是广义上的一个需要在生命周期内保持不变的值,同样的,那在使用useImperativeHandle时我们也不一定要返回ref,比如我们返回子组件内定义的方法:

1const App: React.FC = () => {
2 const globalRef = useRef() as MutableRefObject<any>;
3
4 return (
5 <>
6 <button
7 onClick={() => {
8 console.log(globalRef.current.method());
9 }}
10 >
11 Invoke method from Child
12 </button>
13 <Child ref={globalRef} />
14 </>
15 );
16};
17
18const Child = forwardRef((props, ref) => {
19 const innerMethod = () => 'METHOD_FROM_CHILD';
20
21 useImperativeHandle(ref, () => ({
22 method: innerMethod,
23 }));
24
25 return <p>Child</p>;
26});

原本我们的思维是React中只能子组件调用父组件传入的回调函数,但有时我们的确需要反过来,这时就需要使用这样的思路了。

这个例子里只有一个子组件,假设我们有一个列表,每个列表项都需要挂载一个方法,可能会这么写:

1import React, {
2 useRef,
3 forwardRef,
4 MutableRefObject,
5 Ref,
6 useImperativeHandle,
7} from 'react';
8
9// 我经常被吐槽艺名多... 我也不想啊quq
10const LIST = ['林不渡', '穹心', '一茶'];
11
12type IInnerFunc = () => string;
13type IGlobalRef = {
14 [key: string]: IInnerFunc;
15};
16
17const App: React.FC = () => {
18 const globalRef = useRef(null) as MutableRefObject<IGlobalRef>;
19
20 const invokeAllMountMethod = () => {
21 const globalObject = globalRef?.current;
22 for (const [, method] of Object.entries(globalObject)) {
23 method();
24 }
25 };
26
27 return (
28 <>
29 <button
30 onClick={() => {
31 invokeAllMountMethod();
32 }}
33 >
34 INVOKE
35 </button>
36 {LIST.map((item, idx) => (
37 <Item label={item} idx={idx} key={item} ref={globalRef} />
38 ))}
39 </>
40 );
41};
42
43const Item: React.FC<{
44 label: string;
45 idx: number;
46 ref: Ref<any>;
47}> = forwardRef(({ label, idx }, ref) => {
48 const innerMethod = () => {
49 console.log(`${label}-${idx}`);
50 };
51
52 useImperativeHandle(ref, () => ({
53 [`method-from-${idx}`]: innerMethod,
54 }));
55
56 return <p>{label}</p>;
57});

在这个例子里我们创建了一个globalRef,并在每个列表项组件中都使用这个globalRef进行挂载子组件内部的方法。但是跑一下demo你就会发现只有最后一个列表项的方法被挂载上去了。实际上,我们在前面也提到了这一点:一根垂直管道,你在上方投入了什么,下方拿到的就是什么, 我们始终只有一个globalRef,因此多次调用下最后一次的挂载覆盖掉了前面的。

我们现在就回到了前言中的场景:如何在挂载时将已存在的值和本次挂载的值进行合并?

回想下,useImperativeHandle中我们会把init函数返回的对象挂载到初始ref的current属性上,返回什么就挂载什么。这也意味着我们是能拿到初始refcurrent属性,那么就很简单了,直接把先前的current和本次的对象合并就好了:

1{
2 ...originRef.current,
3 ...convertRefObj,
4};

换到上面的例子,列表项的依次挂载就能够实现了。

useMultiImperativeHandle

直接给源码,因为就没啥复杂的:

1import { useImperativeHandle, MutableRefObject, DependencyList } from 'react';
2
3const useMultiImperativeHandle = <T, K extends object>(
4 originRef: MutableRefObject<T>,
5 convertRefObj: K,
6 deps?: DependencyList
7): void =>
8 useImperativeHandle(
9 originRef,
10 () => {
11 return {
12 ...originRef.current,
13 ...convertRefObj,
14 };
15 },
16 deps
17 );
18
19export default useMultiImperativeHandle;

在上面的例子中使用:

1const Item: React.FC<{
2 label: string;
3 idx: number;
4 ref: Ref<IGlobalRef>;
5}> = forwardRef(({ label, idx }, ref) => {
6 const innerMethod = () => {
7 console.log(`${label}-${idx}`);
8 };
9
10 useMultiImperativeHandle(ref as MutableRefObject<IGlobalRef>, {
11 [`method-from-${idx}`]: innerMethod,
12 });
13
14 return <p>{label}</p>;
15});

Done!这就是我上面的需求实现的基本思路了,使用一个全局唯一的ref,将组件内部的方法挂载到这个ref上而不需要关心有哪些方法,最终只需要遍历上面的方法,然后由这个方法来收集组件数据即可。

真·全文完

这篇文章其实内容没有太多干货,主要是我为了解决动态列表组件的方法挂载而封装的一个简单hook,以及函数式组件中的useRef三兄弟的使用,以及在父组件中调用子组件的方法真的让我感觉挺神奇的,你也许可以试试,看看能不能基于这些hook来根据自己的业务场景定制属于自己的hooks,不论最后的产物是不是很简单(比如这篇文章中的主角),毕竟那代表着你开始潜移默化接受React Hooks思想的第一步。

相关链接: