React / 系统课时

使用 useRef 保存引用

使用 useRef 保存引用

本课解决两个常见问题:如何在 React 组件中访问真实 DOM 节点,以及如何保存一个会变化、但不应触发重新渲染的值。完成后,你能判断何时该用 useRef,何时必须使用状态。

学习目标

  • 使用 useRef 获取并操作 DOM 节点
  • 用 ref.current 保存跨渲染周期的可变值
  • 区分引用变化与状态变化对界面的影响

useRef 的核心作用

useRef 会返回一个在组件整个生命周期内保持同一身份的对象,结构可以理解为 { current: 初始值 }。组件重新渲染时,React 不会创建新的引用对象,而是继续返回原来的对象。

修改 ref.current 不会通知 React 重新渲染。因此,引用适合保存 DOM 节点、定时器编号、上一次值或第三方实例,不适合保存需要立即显示在页面上的数据。

useRef 在渲染周期中的位置

获取 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 中却又希望页面实时展示验证结果,会导致界面与数据不同步。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 useRef 保存引用

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

登录哪都通