Phone icon Связаться с нами

Веб-разработка

Что такое useRef в React?

useRef — это хук React, который возвращает изменяемый объект с единственным свойством current. Этот объект сохраняется всё время существования компонента, а изменение current не вызывает повторный рендер.

Первое назначение — доступ к DOM-элементу: ссылку передают в атрибут ref, и после рендера в current оказывается сам элемент. Так устанавливают фокус в поле, прокручивают к блоку, измеряют размеры или управляют видео.

Второе назначение — хранить значения между рендерами, которые не должны влиять на интерфейс: идентификатор таймера, предыдущее значение пропса, счётчик, экземпляр сторонней библиотеки. Если значение должно отображаться на экране, нужен useState, а не useRef.

Где применяется

useRef используют для автофокуса полей форм, прокрутки к ошибке или новому сообщению в чате, интеграции с библиотеками карт, графиков и редакторов, управления видео и аудио, хранения таймеров и отмены запросов.

В React 19 ref можно передавать дочернему компоненту как обычный проп, без forwardRef. А для более сложных случаев есть хук useImperativeHandle, который ограничивает, что именно доступно через ссылку.

Пример

Автофокус поля поиска и счётчик рендеров без лишних обновлений.

import { useRef, useEffect } from 'react';

function SearchBox() {
  const inputRef = useRef(null);
  const renders = useRef(0);

  useEffect(() => {
    inputRef.current.focus();      // access the DOM element
  }, []);

  renders.current += 1;            // changes without re-render

  return <input ref={inputRef} placeholder="Search courses" />;
}
Ссылка на DOM-элемент и значение в current.

useRef и useState: в чём разница

Изменение useState запускает повторный рендер и обновляет интерфейс. Изменение ref.current ничего не перерисовывает и сразу доступно в коде. Поэтому в состоянии хранят то, что видно на экране, а в ref — служебные значения.

Частые вопросы

Почему ref.current равен null?

Элемент ещё не отрендерился: во время первого рендера DOM-узла ещё нет. Обращаться к ref стоит в useEffect или в обработчиках событий, когда элемент уже на странице.

Можно ли читать ref во время рендера?

Не рекомендуется: значение ref может быть неактуальным, и компонент станет непредсказуемым. Во время рендера используют props и состояние, а ref — в эффектах и обработчиках.

Чем useRef отличается от обычной переменной в компоненте?

Обычная переменная создаётся заново при каждом рендере и теряет значение. Значение в useRef сохраняется между рендерами.

Обучение фронтенд-разработке в OWU

Освойте фронтенд-разработку на практических курсах с менторами и реальными проектами.

Выбрать курс