React / 系统课时

使用 useRef

使用 useRef

useRef 解决两类常见问题:保存跨渲染仍需保留、但变化时不应触发重新渲染的值,以及拿到 React 已挂载的真实 DOM 节点。本节通过一个完整组件同时掌握这两种用法。

学习目标

  • 理解 useRef 返回的对象如何在多次渲染之间保持不变。
  • 使用 ref 保存计时器句柄等可变值,并在不同事件处理函数之间共享。
  • 通过 DOM ref 安全执行聚焦等命令式操作。

useRef 保存的是什么

调用 useRef(initialValue) 会得到一个长期存在的对象,主要通过 ref.current 读取和写入值。组件重新渲染时,React 会继续返回同一个 ref 对象,因此它适合保存计时器 ID、DOM 节点、第三方实例或其他不参与页面渲染的数据。

ref 和 state 的关键差异是:修改 ref.current 不会触发组件重新渲染。如果某个值变化后必须反映在 JSX 中,应使用 state;如果只是事件处理器或副作用需要记住一个句柄,ref 通常更合适。

同时保存 DOM 节点和计时器句柄

下面的组件使用 inputRef 获取输入框节点,用 timerRef 保存计时器 ID。计数需要显示在页面上,因此计数本身仍然由 state 管理。

jsx
import { useEffect, useRef, useState } from 'react';

export default function RefDemo() {
  const inputRef = useRef(null);
  const timerRef = useRef(null);
  const [count, setCount] = useState(0);

  function focusInput() {
    inputRef.current?.focus();
  }

  function startTimer() {
    if (timerRef.current !== null) return;

    timerRef.current = window.setInterval(() => {
      setCount((value) => value + 1);
    }, 1000);
  }

  function stopTimer() {
    if (timerRef.current === null) return;

    window.clearInterval(timerRef.current);
    timerRef.current = null;
  }

  useEffect(() => {
    return () => {
      if (timerRef.current !== null) {
        window.clearInterval(timerRef.current);
        timerRef.current = null;
      }
    };
  }, []);

  return (
    <div>
      <input ref={inputRef} placeholder="输入内容" />
      <button onClick={focusInput}>聚焦输入框</button>
      <button onClick={startTimer}>开始计时</button>
      <button onClick={stopTimer}>停止计时</button>
      <p>计数:{count}</p>
    </div>
  );
}

预期结果

text
点击“聚焦输入框”后,输入框获得焦点。
点击“开始计时”后,计数约每秒加 1;再次点击不会重复创建计时器。
点击“停止计时”后,计数停止增长。

这里 timerRef.current 的变化本身不会刷新页面;真正驱动页面更新的是 setCount。组件卸载时再次检查并清理计时器,可以避免计时任务继续留在浏览器中。

ref 与 state 的边界

需求 更合适的工具 原因
值变化后要更新界面 state 更新会触发重新渲染
保存计时器 ID、第三方实例 ref 需要跨渲染保留,但不参与渲染
聚焦、滚动、测量 DOM ref 需要访问已挂载的真实节点

不要为了减少渲染就把所有状态放进 ref。这样虽然内部值能够变化,但 JSX 不会自动同步,很容易形成界面显示与内部数据不一致的问题。

访问 DOM 时的边界

DOM ref 在节点尚未挂载或已经卸载时可能是 null,所以使用 current 前应考虑这一状态。聚焦、滚动、选中文本和读取尺寸都属于合理的命令式操作,但不应绕过 React 大量修改由 JSX 管理的 DOM 内容。

选择 ref 的判断标准不是“这个值会不会变”,而是“它变化时是否需要触发界面重新渲染”。需要驱动视图就使用 state,只需要跨渲染保存句柄或访问真实节点时再使用 useRef。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 useRef

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通