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 → предпочтительнее.