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 管理。
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>
);
}预期结果
点击“聚焦输入框”后,输入框获得焦点。
点击“开始计时”后,计数约每秒加 1;再次点击不会重复创建计时器。
点击“停止计时”后,计数停止增长。这里 timerRef.current 的变化本身不会刷新页面;真正驱动页面更新的是 setCount。组件卸载时再次检查并清理计时器,可以避免计时任务继续留在浏览器中。
ref 与 state 的边界
| 需求 | 更合适的工具 | 原因 |
|---|---|---|
| 值变化后要更新界面 | state | 更新会触发重新渲染 |
| 保存计时器 ID、第三方实例 | ref | 需要跨渲染保留,但不参与渲染 |
| 聚焦、滚动、测量 DOM | ref | 需要访问已挂载的真实节点 |
不要为了减少渲染就把所有状态放进 ref。这样虽然内部值能够变化,但 JSX 不会自动同步,很容易形成界面显示与内部数据不一致的问题。
访问 DOM 时的边界
DOM ref 在节点尚未挂载或已经卸载时可能是 null,所以使用 current 前应考虑这一状态。聚焦、滚动、选中文本和读取尺寸都属于合理的命令式操作,但不应绕过 React 大量修改由 JSX 管理的 DOM 内容。
选择 ref 的判断标准不是“这个值会不会变”,而是“它变化时是否需要触发界面重新渲染”。需要驱动视图就使用 state,只需要跨渲染保存句柄或访问真实节点时再使用 useRef。