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

useLayoutEffect при SSR

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

useLayoutEffect не выполняется на сервере: там нет DOM и раскладки браузера. На клиенте он может измерить DOM до следующей отрисовки.

Вопрос

Почему измерение layout нельзя выполнить при SSR и что делать с таким компонентом?

Основная идея

Всплывающая подсказка хочет узнать свою высоту, чтобы появиться над кнопкой. На сервере есть только описание HTML: неизвестны реальная ширина окна, шрифт, масштаб и окончательные размеры. Поэтому сервер не может выполнить getBoundingClientRect так, как это делает браузер.

useLayoutEffect запускается после клиентского изменения DOM и до показа соответствующего кадра. Это полезно для измерений, но не помогает серверному HTML сразу иметь окончательную позицию. React может сообщать, что хук не делает ничего на сервере.

Если точное измерение не критично, используйте CSS или обычный эффект. Если блок без него выглядит неправильно, показывайте его только после клиентского монтирования с подходящей заглушкой. Цена такого решения — блок не участвует в полезном первом SSR. Важно выбрать поведение осознанно.

Пример

Универсальное SSR-приложение с клиентской гидрацией; измеряемый компонент появляется только после монтирования в браузере.

import { useEffect, useLayoutEffect, useRef, useState } from 'react';
 
function MeasuredNote() {
  const ref = useRef(null);
  const [height, setHeight] = useState(0);
  useLayoutEffect(() => {
    setHeight(ref.current.getBoundingClientRect().height);
  }, []);
  return <div ref={ref}>Высота заметки: {height.toFixed(0)} px</div>;
}
export default function ClientNote() {
  const [mounted, setMounted] = useState(false);
  useEffect(() => setMounted(true), []);
  return mounted ? <MeasuredNote /> : <p>Готовим заметку...</p>;
}

Сервер и первый клиентский рендер показывают одинаковую заглушку. Только после эффекта монтируется MeasuredNote, где DOM уже существует и можно измерить высоту.

Варианты решения

ПодходПлюсыМинусы
Позиционировать через CSS (position, flex/grid, CSS Anchor Positioning)Работает в SSR, без JSНе всё выразимо стилями
Рендер только на клиенте (флаг mounted, use(browser()) в 19.3)Точное измерениеБлок не попадает в серверный HTML, нужна заглушка того же размера
useEffect вместо useLayoutEffectНет предупреждений SSRВозможен видимый «прыжок» после отрисовки
Библиотеки позиционирования (Floating UI)Учитывают SSR и пересчёт при скроллеДополнительная зависимость
Изоморфный хук useIsomorphicLayoutEffectБез предупреждений на сервереНичего не измеряет на сервере — просто прячет проблему
// Встречается в библиотеках: на сервере useEffect (ничего не делает), в браузере useLayoutEffect
const useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
/* CSS Anchor Positioning: подсказка над кнопкой без JS-измерений */
.trigger { anchor-name: --tip; }
.tooltip {
  position: absolute;
  position-anchor: --tip;
  bottom: anchor(top);
  left: anchor(center);
  translate: -50% -8px;
}

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

  • Не делайте layout-измерения в render.
  • useLayoutEffect блокирует браузерную отрисовку; тяжёлая работа внутри ухудшает отзывчивость.
  • Если содержимое меняется после измерения, одного [] недостаточно; иногда нужен ResizeObserver.
  • Заглушка должна резервировать место, если важна стабильность layout.

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

SSR → DOM/layout нет. Клиентский commit → layout effect → измерение → кадр. Можно решить CSS → предпочтительнее.

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

useLayoutEffect и серверный рендеринг.

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

Поиск

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