0

0

如何在 React 中正确使用 useRef 创建动态引用数组

花韻仙語

花韻仙語

发布时间:2026-01-16 08:57:10

|

111人浏览过

|

来源于php中文网

原创

如何在 React 中正确使用 useRef 创建动态引用数组

本文讲解如何规避“react hook 'useref' cannot be called inside a callback”错误,通过 `useref` 持有引用数组并结合回调 ref 实现动态 dom 元素引用管理,适用于滚动定位、焦点控制等场景。

在 React 中,Hooks 的调用必须严格遵守规则:只能在函数组件的顶层或自定义 Hook 的顶层调用,不能在循环、条件语句或回调函数中调用(如 forEach、map 内部)。你原代码中在 labels.forEach(...) 回调里调用 useRef(null),直接违反了这一规则,因此触发 ESLint 和运行时警告。

✅ 正确做法是:用一个 useRef 容器(如数组)统一管理多个 DOM 引用,并通过回调 ref(callback ref)动态赋值。这种方式既符合 Hooks 规则,又能灵活支持动态数量的元素。

✅ 推荐实现方案(推荐用于滚动定位等场景)

import { useRef, useEffect } from 'react';

// 自定义 Hook:返回一个 refs 数组容器和初始化函数
const useDivRefs = (length: number) => {
  const refs = useRef<(HTMLDivElement | null)[]>([]);

  // 确保 refs.current 长度匹配(避免 stale length)
  useEffect(() => {
    if (refs.current.length < length) {
      refs.current = Array(length).fill(null);
    }
  }, [length]);

  return refs;
};

const MyComponent = () => {
  const labels = ['div 1', 'div 2', 'div 3'];

  // 创建一个 ref 容器,持有 3 个 null 初始值
  const divRefs = useDivRefs(labels.length);

  // 示例:滚动到指定索引的元素
  const scrollToSection = (index: number) => {
    const el = divRefs.current[index];
    if (el) el.scrollIntoView({ behavior: 'smooth' });
  };

  return (
    
{/* 渲染带 ref 的元素 */} {labels.map((label, i) => { const targetId = label.replace(/\s+/g, ''); return (
{ divRefs.current[i] = el; // ✅ 安全:不调用 Hook,仅赋值 }} style={{ scrollMarginTop: '80px' }} // 可选:避免被固定头部遮挡 >

{label}

Section content...

动态WEB网站中的PHP和MySQL:直观的QuickPro指南第2版
动态WEB网站中的PHP和MySQL:直观的QuickPro指南第2版

动态WEB网站中的PHP和MySQL详细反映实际程序的需求,仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法,让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能,对常用的、强大的包

下载
); })} {/* 导航按钮示例 */}
); }; export default MyComponent;

⚠️ 注意事项

  • 不要在 map/forEach 中调用 useRef:每个 useRef() 调用都必须是顶层静态调用,React 依赖调用顺序来匹配 state/ref。
  • 回调 ref 是安全的副作用操作:ref={(el) => {...}} 是纯赋值逻辑,不涉及 Hook 调用,完全合规。
  • useRef([]) 返回的是 MutableRefObject,其 .current 属性可被任意修改,适合存储 DOM 节点列表。
  • 若需响应 labels 动态变化(如增删),建议配合 useEffect 清理或重置 refs.current,避免引用残留。

✅ 总结

要为动态生成的元素创建多个引用,核心思路是:

  1. 单次顶层 useRef 创建容器(如 useRef([]));
  2. 用回调 ref 将节点逐个写入该容器
  3. 通过索引安全访问(如 refs.current[i])完成滚动、聚焦等交互

这样既彻底规避了 Rules of Hooks 报错,又保持了代码的可维护性与性能(无重复渲染、无额外 Hook 开销)。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

231

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

436

2024.03.01

php中foreach用法
php中foreach用法

本专题整合了php中foreach用法的相关介绍,阅读专题下面的文章了解更多详细教程。

42

2025.12.04

golang map内存释放
golang map内存释放

本专题整合了golang map内存相关教程,阅读专题下面的文章了解更多相关内容。

75

2025.09.05

golang map相关教程
golang map相关教程

本专题整合了golang map相关教程,阅读专题下面的文章了解更多详细内容。

32

2025.11.16

golang map原理
golang map原理

本专题整合了golang map相关内容,阅读专题下面的文章了解更多详细内容。

59

2025.11.17

java判断map相关教程
java判断map相关教程

本专题整合了java判断map相关教程,阅读专题下面的文章了解更多详细内容。

36

2025.11.27

DOM是什么意思
DOM是什么意思

dom的英文全称是documentobjectmodel,表示文件对象模型,是w3c组织推荐的处理可扩展置标语言的标准编程接口;dom是html文档的内存中对象表示,它提供了使用javascript与网页交互的方式。想了解更多的相关内容,可以阅读本专题下面的文章。

2975

2024.08.14

Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

8

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 3.7万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.0万人学习

React核心原理新老生命周期精讲
React核心原理新老生命周期精讲

共12课时 | 1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号