源码分析之React中useRef解析

流程分析

useRef架构图

useRef的流程架构图如下:
是
是
否
是
旧ref存在
新ref存在
更新:增删改
updateRef方法
旧fiber存在且旧ref不存在?(ref删除了)
首次渲染或者新旧ref不一样
首次渲染
mountRef方法
beginWork阶段
markRef检测

workInProgress.ref==null
workInProgress.flags打标记flag
commit阶段
commitMutationEffectsOnFiber
满足current!== null等条件才调用:safelyDetachRef解绑
current.ref!=null?
解绑操作
commitLayoutEffectOnFiber
commitAttachRef
finishedWork.ref!=null?
绑定赋值

相关方法解析

mountRef方法

在首次渲染挂载时,useRef调用的是mountRef。

js 复制代码
function mountRef(initialValue) {
  // 创建hook,将hook绑定fiber的updateQueue上并返回
  const hook = mountWorkInProgressHook();
  // 包装ref值
  const ref = { current: initialValue };
  // 将值保存到hook.memoizedState上
  hook.memoizedState = ref;
  return ref;
}
updateRef
js 复制代码
function updateRef(initialValue) {
  // 获取fiber上的新hook,新hook来自于旧fiber上的旧hook 
  const hook = updateWorkInProgressHook();
  // 返回新hook的memoizedState
  return hook.memoizedState;
}

通过mountRef和updateRef可知,userRef的hook在updateQueue上就是一个赋值/取值的操作。

markRef方法

useRef的标记发生在beginWork 阶段,会调用markRef方法,在组件更新时,检查ref是否发生变化,并给Fiber节点打上"需要更新ref"的标记。

js 复制代码
function markRef(current, workInProgress) {
  // 取出新fiber上的ref
  const ref = workInProgress.ref;
  // 若新fiber上没有ref
  if (ref === null) {
    // 旧fiber存在,且存在ref
    if (current !== null && current.ref !== null) {
     // 则说明ref被删除了,打上标记,后续需要清空旧ref
      workInProgress.flags |= Ref | RefStatic;
    }
  } else {
    // 判断ref的类型是否是函数或对象,若不是,则报错
    if (typeof ref !== 'function' && typeof ref !== 'object') {
      throw new Error(
        'Expected ref to be a function, an object returned by React.createRef(), or undefined/null.',
      );
    }
    // 组件首次渲染时,或者是新旧ref不同,则也需要打上标记
    if (current === null || current.ref !== ref) {
      workInProgress.flags |= Ref | RefStatic;
    }
  }
}

首次渲染或者新旧fiber的ref不等,以及ref被删除,在fiber.flags上的标记都是一样。

safelyDetachRef方法

在commitMutationEffectsOnFiber中调用safelyDetachRef方法,若当前不是首次渲染且fiber.flag有Ref标记则需要清理ref,此外在组件卸载时也需要调用fiber.flag,释放对DOM的引用。

js 复制代码
function safelyDetachRef(
  current
) {
// current是指当前UI展示的fiber
  const ref = current.ref;
  const refCleanup = current.refCleanup;
// 若ref存在,且fiber.flags上标记了需要更新,则先进行ref的清理
  if (ref !== null) {
   // 先判断清理方法是否是函数
    if (typeof refCleanup === 'function') {
      try {
      // 执行清理函数
        refCleanup();
      } catch (error) {
        // 报错
      } finally {
        // 重置新fiber、旧fiber上的ref清理函数 
        current.refCleanup = null;
        const finishedWork = current.alternate;
        if (finishedWork != null) {
          finishedWork.refCleanup = null;
        }
      }
    } else if (typeof ref === 'function') {
    // 判断 ref是否是函数
      try {
      // 是函数,则再调用一遍
        ref(null);
      } catch (error) {
        // 报错
      }
    } else {
    // 若ref不是函数,则将ref.current重置
      ref.current = null;
    }
  }
}
绑定赋值

一般在commitLayoutEffectOnFiber中调用,此时已经可以拿到DOM了。

js 复制代码
function commitLayoutEffectLayoutOnFiber(
  finishedRoot,
  current,
  finishedWork,
  committedLanes,
) {
  const flags = finishedWork.flags;
  switch (finishedWork.tag) {
    case ClassComponent: {
      //...
      if (flags & Ref) {
        safelyAttachRef(finishedWork, finishedWork.return);
      }
    }
    case HostHoistable:
    case HostComponent: {
      if (flags & Ref) {
        safelyAttachRef(finishedWork, finishedWork.return);
      }
    }
  }
}

如下的safelyAttachRef本质上就是调用commitAttachRef方法

js 复制代码
function commitAttachRef(finishedWork) {
  const ref = finishedWork.ref;
  if (ref !== null) {
    let instanceToUse;
    switch (finishedWork.tag) {
      case HostHoistable:
      case HostSingleton:
      case HostComponent:
        instanceToUse = finishedWork.stateNode;
        break;
      case ViewTransitionComponent: {
       
        instanceToUse = finishedWork.stateNode;
        break;
      }
      default:
        instanceToUse = finishedWork.stateNode;
    }
    // 判断ref的类型
    if (typeof ref === 'function') {
      // 只有ref为函数且有返回值,返回值需要是函数,才可以在后续执行ref清理  
      finishedWork.refCleanup = ref(instanceToUse);
    } else {
      ref.current = instanceToUse;
    }
  }
}
注意事项

在safelyDetachRef和commitAttachRef方法中操作的都是fiber.ref,它与hook.memoizedState实际上是同一个引用地址,如下:

js 复制代码
function FC()=>{
    const divRef=useRef();
    return <div ref={divRef}>Hello word</div>    
}

ref={divRef}就是将hook.memoziedState和fiber.ref关联起来。

相关推荐
程序员大阳1 小时前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
濮水大叔1 小时前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
SoaringHeart2 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Flynt3 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑3 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星4 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson4 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼4 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
七仔啊5 小时前
CNC计算机数控加工模拟器
前端
张一凡935 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent