re:re:actable
Урок 114 минуты чтения

Как работать с DOM в React

На этой странице
Кратко

В React содержимое страницы описывают через JSX и state, а DOM обновляет сам React. Прямой доступ к DOM нужен для императивных задач, которые нельзя выразить состоянием: фокус, прокрутка, выделение текста, измерение размеров, воспроизведение медиа, интеграция со сторонними библиотеками (графики, карты, редакторы). Для этого используют ref: useRef(null) + атрибут ref={...}, после commit React кладёт узел в ref.current (при размонтировании — null). Работать с ref нужно в обработчиках событий и эффектах, но не во время рендера. Нельзя вручную менять или удалять узлы, которыми управляет React (innerHTML, removeChild, appendChild) — это ломает сравнение деревьев.

Вопрос

Когда в React нужен прямой доступ к DOM и как правильно его получать? Почему нельзя вручную менять элементы, которыми управляет React?

Два источника правды — проблема

function Price({ value }) {
  const ref = useRef(null);
  useEffect(() => {
    ref.current.textContent = `${value} ₽ (скидка!)`; // ✗ ручная правка содержимого
  }, []);
  return <span ref={ref}>{value} ₽</span>;
}

React считает, что в span лежит "{value} ₽". При следующем рендере он перезапишет текст или, хуже, будет сравнивать с неверным состоянием DOM. Правильно — выразить это данными: <span>{value} ₽{hasDiscount && " (скидка!)"}</span>.

Что делать через ref, а что — через state

ЗадачаКак
Текст, классы, видимость, атрибутыState + JSX
Фокус в полеref.current.focus()
Прокрутить к элементуref.current.scrollIntoView({ behavior: "smooth" })
Узнать размерыref.current.getBoundingClientRect(), ResizeObserver
Видео: play/pauseref.current.play()
Выделить текстref.current.select()
График, карта, редакторСоздать экземпляр на ref.current в эффекте, удалить в cleanup
Canvasref.current.getContext("2d")

Пример 1: фокус и прокрутка

import { useRef, useState } from "react";
 
export default function Comments({ comments }) {
  const inputRef = useRef(null);
  const listEndRef = useRef(null);
  const [text, setText] = useState("");
 
  return (
    <section>
      <ul>
        {comments.map((c) => <li key={c.id}>{c.text}</li>)}
        <li ref={listEndRef} aria-hidden="true" />
      </ul>
 
      <button onClick={() => listEndRef.current?.scrollIntoView({ behavior: "smooth" })}>
        К последнему комментарию
      </button>
 
      <label>
        Комментарий
        <input ref={inputRef} value={text} onChange={(e) => setText(e.target.value)} />
      </label>
      <button onClick={() => inputRef.current?.focus()}>Ответить</button>
    </section>
  );
}

Значение поля управляется state, а фокус и прокрутка — вызовами DOM-методов. Они не конфликтуют: focus() не меняет описание интерфейса.

Пример 2: сторонняя библиотека

import { useEffect, useRef } from "react";
import { Chart } from "chart.js/auto";
 
function SalesChart({ data }) {
  const canvasRef = useRef(null);
 
  useEffect(() => {
    const chart = new Chart(canvasRef.current, {
      type: "line",
      data: { labels: data.labels, datasets: [{ label: "Продажи", data: data.values }] },
    });
    return () => chart.destroy(); // обязательно: иначе утечка и «двойной» график в StrictMode
  }, [data]);
 
  return <canvas ref={canvasRef} aria-label="График продаж" role="img" />;
}

React управляет только <canvas>, а содержимым внутри — библиотека. Граница ответственности чёткая.

Когда ref заполнен

Render: компонент вызван, ref.current ещё null (или старый узел)
Commit: React создал/обновил DOM → ref.current = узел
        → useLayoutEffect → браузер рисует → useEffect
Размонтирование: ref.current = null
function Bad() {
  const ref = useRef(null);
  ref.current?.focus(); // ✗ во время рендера: узла ещё нет, и это побочный эффект
  return <input ref={ref} />;
}

Измерение до отрисовки

function Tooltip({ targetRect, children }) {
  const ref = useRef(null);
  const [top, setTop] = useState(0);
 
  useLayoutEffect(() => {
    const { height } = ref.current.getBoundingClientRect();
    setTop(targetRect.top - height - 8); // посчитать до кадра, чтобы не было «прыжка»
  }, [targetRect]);
 
  return <div ref={ref} style={{ position: "fixed", top }}>{children}</div>;
}

useLayoutEffect выполняется после изменения DOM, но до отрисовки — пользователь не увидит промежуточное положение. Используй его только для измерений, влияющих на раскладку.

Ref-колбэк

<div
  ref={(node) => {
    if (!node) return;
    const observer = new ResizeObserver(([entry]) => setWidth(entry.contentRect.width));
    observer.observe(node);
    return () => observer.disconnect(); // React 19: cleanup у ref-колбэка
  }}
/>

Удобно, когда нужно отреагировать на появление узла или работать со списком узлов.

Частые ошибки

  • document.querySelector для своего элемента — ref надёжнее: он привязан к конкретному экземпляру компонента.
  • Изменение innerHTML или удаление узлов, созданных React.
  • Доступ к ref.current во время рендера.
  • Забытый cleanup для библиотек и наблюдателей.
  • Обращение к DOM на сервере (SSR): document и window там нет — только в эффектах.

Что важно помнить

  • Содержимое — через state и JSX; императивные операции — через ref.
  • ref.current заполняется в commit и может быть null.
  • Работа с ref — в обработчиках и эффектах.
  • Сторонние библиотеки — в эффекте с cleanup.
  • useLayoutEffect — только для измерений до отрисовки.

Мини-шпаргалка

  • const ref = useRef(null) + <input ref={ref} />.
  • Фокус, прокрутка, размеры, медиа, библиотеки → ref.
  • Текст, классы, видимость → state.
  • Не менять узлы React вручную.
  • Ref-колбэк с cleanup (React 19).

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам