Как работать с 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/pause | ref.current.play() |
| Выделить текст | ref.current.select() |
| График, карта, редактор | Создать экземпляр на ref.current в эффекте, удалить в cleanup |
| Canvas | ref.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 = nullfunction 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).