React 18 使用 ref 引用值

参考文章

使用 ref 引用值

当希望组件“记住”某些信息,但又不想让这些信息 触发新的渲染 时,可以使用 ref

给组件添加 ref

可以通过从 React 导入 useRef Hook 来为组件添加一个 ref:

import { useRef } from 'react';

在组件内,调用 useRef Hook 并传入想要引用的初始值作为唯一参数。例如,这里的 ref 引用的值是“0”:

const ref = useRef(0);

useRef 返回一个这样的对象:

{ 
  current: 0 // 向 useRef 传入的值
}

可以用 ref.current 属性访问该 ref 的当前值。这个值是有意被设置为可变的,意味着既可以读取它也可以写入它。就像一个 React 追踪不到的、用来存储组件信息的秘密“口袋”。(这就是让它成为 React 单向数据流的“应急方案”的原因)

这里,每次点击按钮时会使 ref.current 递增:

import { useRef } from 'react';

export default function Counter() {
  let ref = useRef(0);

  function handleClick() {
    ref.current = ref.current + 1;
    alert('你点击了 ' + ref.current + ' 次!');
  }

  return (
    <button onClick={handleClick}>
      点击我!
    </button>
  );
}

这里的 ref 指向一个数字,但是,像 state 一样,可以让它指向任何东西:字符串、对象,甚至是函数。与 state 不同的是,ref 是一个普通的 JavaScript 对象,具有可以被读取和修改的 current 属性。

注意:组件不会在每次递增时重新渲染。 与 state 一样,React 会在每次重新渲染之间保留 ref。但是,设置 state 会重新渲染组件,更改 ref 不会!

示例:制作秒表

可以在单个组件中把 ref 和 state 结合起来使用。例如,让我们制作一个秒表,用户可以通过按按钮来使其启动或停止。为了显示从用户按下“开始”以来经过的时间长度,需要追踪按下“开始”按钮的时间和当前时间。此信息用于渲染,所以会把它保存在 state 中:

const [startTime, setStartTime] = useState(null);

const [now, setNow] = useState(null);

当用户按下“开始”时,将用 setInterval 每 10 毫秒更新一次时间:

import { useState } from 'react';

export default function Stopwatch() {
  const [startTime, setStartTime] = useState(null);
  const [now, setNow] = useState(null);

  function handleStart() {
    // 开始计时。
    setStartTime(Date.now());
    setNow(Date.now());

    setInterval(() => {
      // 每 10ms 更新一次当前时间。
      setNow(Date.now());
    }, 10);
  }

  let secondsPassed = 0;
  if (startTime != null && now != null) {
    secondsPassed = (now - startTime) / 1000;
  }

  return (
    <>
      <h1>时间过去了: {secondsPassed.toFixed(3)}</h1>
      <button onClick={handleStart}>
        开始
      </button>
    </>
  );
}

当按下“停止”按钮时,需要取消现有的 interval,以便让它停止更新 now state 变量。可以通过调用 clearInterval 来完成此操作。但需要为其提供 interval ID,此 ID 是之前用户按下 Start、调用 setInterval 时返回的。需要将 interval ID 保留在某处。 由于 interval ID 不用于渲染,可以将其保存在 ref 中:

import { useState, useRef } from 'react';

export default function Stopwatch() {
  const [startTime, setStartTime] = useState(null);
  const [now, setNow] = useState(null);
  const intervalRef = useRef(null);

  function handleStart() {
    setStartTime(Date.now());
    setNow(Date.now());

    clearInterval(intervalRef.current);
    intervalRef.current = setInterval(() => {
      setNow(Date.now());
    }, 10);
  }

  function handleStop() {
    clearInterval(intervalRef.current);
  }

  let secondsPassed = 0;
  if (startTime != null && now != null) {
    secondsPassed = (now - startTime) / 1000;
  }

  return (
    <>
      <h1>时间过去了: {secondsPassed.toFixed(3)}</h1>
      <button onClick={handleStart}>
        开始
      </button>
      <button onClick={handleStop}>
        停止
      </button>
    </>
  );
}

当一条信息用于渲染时,将它保存在 state 中。

当一条信息仅被事件处理器需要,并且更改它不需要重新渲染时,使用 ref 可能会更高效。

ref 和 state 的不同之处

也许你觉得 ref 似乎没有 state 那样“严格” —— 例如,可以改变它们而非总是必须使用 state 设置函数。但在大多数情况下,建议使用 state。ref 是一个“应急方案”,并不会经常用到它。 以下是 state 和 ref 的对比:

ref state
useRef(initialValue)返回 { current: initialValue } useState(initialValue) 返回 state 变量的当前值和一个 state 设置函数 ( [value, setValue])
更改时不会触发重新渲染 更改时触发重新渲染。
可变 —— 可以在渲染过程之外修改和更新 current 的值。 “不可变” —— 必须使用 state 设置函数来修改 state 变量,从而排队重新渲染。
不应在渲染期间读取(或写入) current 值。 可以随时读取 state。但是,每次渲染都有自己不变的 state 快照。

这是一个使用 state 实现的计数器按钮:

import { useState } from 'react';

export default function Counter() {
  const [count, setCount] = useState(0);

  function handleClick() {
    setCount(count + 1);
  }

  return (
    <button onClick={handleClick}>
      你点击了 {count}</button>
  );
}

因为 count 的值将会被显示,所以为其使用 state 是合理的。当使用 setCount() 设置计数器的值时,React 会重新渲染组件,并且屏幕会更新以展示新的计数。

如果试图用 ref 来实现它,React 永远不会重新渲染组件,所以永远不会看到计数变化!看看点击这个按钮如何 不更新它的文本

import { useRef } from 'react';

export default function Counter() {
  let countRef = useRef(0);

  function handleClick() {
    // 这样并未重新渲染组件!
    countRef.current = countRef.current + 1;
  }

  return (
    <button onClick={handleClick}>
      你点击了 {countRef.current}</button>
  );
}

这就是为什么在渲染期间读取 ref.current 会导致代码不可靠的原因。如果需要,请改用 state。

何时使用 ref

通常,当组件需要“跳出” React 并与外部 API 通信时,会用到 ref —— 通常是不会影响组件外观的浏览器 API。

以下是这些罕见情况中的几个:

  • 存储 timeout ID
  • 存储和操作 DOM 元素
  • 存储不需要被用来计算 JSX 的其他对象。

如果组件需要存储一些值,但不影响渲染逻辑,请选择 ref。

ref 的最佳实践

遵循这些原则将使组件更具可预测性:

  • 将 ref 视为应急方案。 当使用外部系统或浏览器 API 时,ref 很有用。如果很大一部分应用程序逻辑和数据流都依赖于 ref,可能需要重新考虑你的方法。
  • 不要在渲染过程中读取或写入 ref.current 如果渲染过程中需要某些信息,请使用 state 代替。由于 React 不知道 ref.current 何时发生变化,即使在渲染时读取它也会使组件的行为难以预测。(唯一的例外是像 if (!ref.current) ref.current = new Thing() 这样的代码,它只在第一次渲染期间设置一次 ref。)

React state 的限制不适用于 ref。例如,state 就像 每次渲染的快照,并且 不会同步更新。但是当你改变 ref 的 current 值时,它会立即改变:

ref.current = 5;

console.log(ref.current); // 5

这是因为 ref 本身是一个普通的 JavaScript 对象, 所以它的行为就像对象那样。

当使用 ref 时,也无需担心 避免变更。只要改变的对象不用于渲染,React 就不会关心对 ref 或其内容做了什么。

ref 和 DOM

可以将 ref 指向任何值。但是,ref 最常见的用法是访问 DOM 元素。例如,如果想以编程方式聚焦一个输入框,这种用法就会派上用场。当将 ref 传递给 JSX 中的 ref 属性时,比如

,React 会将相应的 DOM 元素放入 myRef.current 中。

摘要

  • ref 是一个应急方案,用于保留不用于渲染的值。 不会经常需要它们。
  • ref 是一个普通的 JavaScript 对象,具有一个名为 current 的属性,可以对其进行读取或设置。
  • 可以通过调用 useRef Hook 来让 React 给组件一个 ref。
  • 与 state 一样,ref 允许在组件的重新渲染之间保留信息。
  • 与 state 不同,设置 ref 的 current 值不会触发重新渲染。
  • 不要在渲染过程中读取或写入 ref.current。这使组件难以预测。

你可能感兴趣的:(前端,react,react.js,ref,useRef)