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

useLayoutEffect: когда выполняется и когда его использовать

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

useLayoutEffect работает как useEffect, но выполняется синхронно после изменения DOM и до того, как браузер нарисует кадр. Пока эффект не завершится, пользователь ничего не увидит. Это нужно, когда надо измерить DOM (размеры, позицию) и сразу поправить разметку — например, расположить тултип — без мигания. Цена — блокировка отрисовки, поэтому по умолчанию используют useEffect.

Вопрос

Что делает useLayoutEffect? Когда React его выполняет и в каких случаях его стоит использовать?

Порядок выполнения

render → commit: DOM обновлен
       → useLayoutEffect (синхронно, браузер ждет)
       → браузер рисует кадр
       → useEffect (асинхронно)

Если внутри useLayoutEffect обновить state, React перерендерит компонент до отрисовки — пользователь увидит только итоговый результат.

Пример: позиционирование тултипа

import { useLayoutEffect, useRef, useState } from "react";
 
function Tooltip({ targetRect, children }) {
  const ref = useRef(null);
  const [height, setHeight] = useState(0);
 
  useLayoutEffect(() => {
    setHeight(ref.current.getBoundingClientRect().height);
  }, []);
 
  const top = targetRect.top - height < 0 ? targetRect.bottom : targetRect.top - height;
 
  return <div ref={ref} style={{ position: "absolute", top }}>{children}</div>;
}

С useEffect тултип сначала отрисовался бы в неправильном месте, а потом «прыгнул».

useEffect и useLayoutEffect

useEffectuseLayoutEffect
Когдапосле отрисовкипосле изменения DOM, до отрисовки
Блокирует отрисовкунетда
Для чегозапросы, подписки, логированиеизмерение DOM, синхронная правка layout, скролл
SSRне выполняется на серверене выполняется, в старых версиях — предупреждение

Когда использовать

  • измерить элемент и сразу изменить положение или размер;
  • восстановить позицию прокрутки до отрисовки;
  • синхронизировать анимацию с DOM;
  • избежать видимого мигания при правке layout.

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

  • Тяжелая работа в useLayoutEffect замедляет отрисовку каждого кадра.
  • На сервере эффекты не выполняются; для SSR-безопасного кода используют useEffect или проверяют окружение.
  • Для CSS-in-JS библиотек, вставляющих стили, есть useInsertionEffect — он срабатывает еще раньше.
  • Cleanup useLayoutEffect тоже выполняется синхронно.

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

useLayoutEffect — после DOM, до отрисовки, синхронно. Для измерений и правок layout без мигания. Блокирует отрисовку — по умолчанию useEffect.

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

React: useLayoutEffect, React: Measuring layout before the browser repaints.

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

Поиск

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