React / 系统课时
使用 useRef 保存引用
使用 useRef 保存引用
本课解决两个常见问题:如何在 React 组件中访问真实 DOM 节点,以及如何保存一个会变化、但不应触发重新渲染的值。完成后,你能判断何时该用 useRef,何时必须使用状态。
学习目标
- 使用
useRef获取并操作 DOM 节点 - 用
ref.current保存跨渲染周期的可变值 - 区分引用变化与状态变化对界面的影响
useRef 的核心作用
useRef 会返回一个在组件整个生命周期内保持同一身份的对象,结构可以理解为 { current: 初始值 }。组件重新渲染时,React 不会创建新的引用对象,而是继续返回原来的对象。
修改 ref.current 不会通知 React 重新渲染。因此,引用适合保存 DOM 节点、定时器编号、上一次值或第三方实例,不适合保存需要立即显示在页面上的数据。

获取 DOM 节点
下面的组件在点击按钮后让输入框获得焦点。inputRef 先以 null 初始化,元素挂载完成后,React 会把真实的 input 节点写入 inputRef.current。
jsx
import { useRef } from "react";
export default function FocusInput() {
const inputRef = useRef(null);
function handleFocus() {
// 元素尚未挂载时 current 可能为 null,因此使用可选链
inputRef.current?.focus();
}
return (
<section>
<input ref={inputRef} placeholder="请输入内容" />
<button type="button" onClick={handleFocus}>
聚焦输入框
</button>
</section>
);
}预期结果
text
页面显示一个输入框和“聚焦输入框”按钮。
点击按钮后,光标进入输入框,组件不会因为 focus() 再次渲染。只应在事件处理函数或副作用中读取、操作 DOM。渲染期间直接访问 ref.current,可能读到 null 或旧节点,也会让组件行为难以预测。
保存不触发渲染的可变值
引用还可以保存与界面无直接关系的数据。例如,记录按钮被点击的次数,但不把次数显示在页面中:
jsx
import { useRef } from "react";
export default function ClickTracker() {
const clickCountRef = useRef(0);
function handleClick() {
clickCountRef.current += 1;
console.log(`已点击 ${clickCountRef.current} 次`);
}
return (
<button type="button" onClick={handleClick}>
记录点击
</button>
);
}预期输出
text
已点击 1 次
已点击 2 次每次点击都会更新 current,但页面不会重新渲染。若页面必须显示最新次数,应改用 useState,因为状态更新会安排一次新的渲染。
引用与状态的选择边界
判断标准不是“数据会不会变化”,而是“变化后界面是否需要更新”。界面依赖的数据放入状态;仅供事件、清理逻辑或外部 API 使用的数据可以放入引用。
| 对比项 | useRef |
useState |
|---|---|---|
| 更新后是否重新渲染 | 否 | 是 |
| 是否跨渲染保留 | 是 | 是 |
| 典型用途 | DOM、定时器、实例、上一次值 | 表单值、加载状态、计数、筛选条件 |
| 读取位置 | 事件或副作用中为主 | 渲染过程和事件中 |
不要使用引用绕过正常的数据流。例如,把表单输入全部保存在 ref.current 中却又希望页面实时展示验证结果,会导致界面与数据不同步。
按自己的节奏,确认真正理解。