Кальтер / Блог

GSAP в React: очистка анимаций, reduced motion и проверка производительности

Как ограничить GSAP-анимации жизненным циклом React-компонента, обработать prefers-reduced-motion и профилировать реальную страницу без обещаний FPS.

Материал подготовлен с помощью ИИ; источники и технические формулировки проверены редакцией ZASLON.

У движения есть границы: MOUNT, MOTION, CLEANUP.
Оригинальная редакционная схема ZASLON, созданная программно. Условная структура процесса, не скриншот продукта.

Короткий ответ: в React создай GSAP-анимацию внутри области компонента, чтобы её можно было откатить при повторном эффекте, смене зависимости или размонтировании. Для разных настроек экрана и prefers-reduced-motion можно использовать gsap.matchMedia(), а отзывчивость проверять профайлером в реальном интерфейсе. Очистка, доступность и производительность — три отдельные проверки; GSAP не гарантирует последние две автоматически.

Ниже пример для API GSAP 3 и React с официальным hook useGSAP. Он показывает схему владения, а не готовый компонент для любой версии приложения. Проверь импорты, версии и особенности router/build своего проекта. Руководство GSAP & React предлагает useGSAP как React-интеграцию с cleanup; gsap.context() описывает область селекторов и revert() для созданных внутри неё анимаций и ScrollTriggers.

Жизненный цикл: создать, использовать, очистить

import { useRef } from "react";
import { gsap } from "gsap";
import { useGSAP } from "@gsap/react";

gsap.registerPlugin(useGSAP);

function Card() {
  const root = useRef(null);

  useGSAP(() => {
    const mm = gsap.matchMedia(root);

    mm.add("(prefers-reduced-motion: no-preference)", () => {
      gsap.from(".card__body", { y: 12, opacity: 0, duration: 0.35 });
    });

    mm.add("(prefers-reduced-motion: reduce)", () => {
      gsap.set(".card__body", { clearProps: "transform,opacity" });
    });

    return () => mm.revert();
  }, { scope: root });

  return <article ref={root} className="card">
    <div className="card__body">Содержимое доступно и без анимации</div>
  </article>;
}

В первом варианте hook ограничивает GSAP-селекторы потомками root, а cleanup закрывает объект matchMedia. В reduced-motion ветке текст остаётся в документе; для такого простого случая базовый CSS также должен показывать его без ожидания JS. Если анимация запускается из обработчика, созданного позже, проверь contextSafe()/scope-паттерн из React guide GSAP: поздно созданная анимация должна попасть в тот же контекст или получить собственную очистку. DOM-обработчики и сторонние ресурсы, созданные тобой, тоже требуют твоей очистки.

В обычном React useEffect синхронизирует компонент с внешней системой. Возвращённая функция cleanup вызывается перед повторной синхронизацией и при удалении компонента; в Strict Mode разработки React делает дополнительный цикл setup/cleanup, чтобы обнаруживать некорректную симметрию (React useEffect). Это означает, что двойной mount в development — повод проверить владельца side effect и cleanup, а не повод отключать Strict Mode. Если используешь обычный effect вместо useGSAP, можно создать const ctx = gsap.context(() => { ... }, root.current) и вернуть () => ctx.revert(). context управляет откатом созданных анимаций, а не управлением timeline play/pause.

Reduced motion — отдельное состояние интерфейса

prefers-reduced-motion передаёт настройку пользователя сократить или заменить несущественное движение. MDN описывает media feature; gsap.matchMedia() умеет запускать разные наборы анимаций для media query и откатывать их, когда условие перестаёт выполняться.

В полной версии можно оставить небольшое появление, а в reduced-ветке убрать параллакс, zoom, scrub и длинные перемещения. Смысловая информация не должна зависеть от того, увидел ли посетитель движение. Не устанавливай элементу opacity: 0 как единственный способ показать его, иначе отключённый JavaScript или ошибка анимации могут скрыть содержание. Если пользователь меняет системную настройку при открытой странице, проверь, что ветка пересобирается без наложенных старых tween/ScrollTrigger. При маршрутизации тестируй не только переход вперёд, но и возврат назад.

Проверка Действие Ожидаемое наблюдение
Mount/unmount Открой компонент и уйди с маршрута несколько раз Нет наложенных tween, триггеров или listener
Dependency update Измени prop, который должен перестроить сцену Старый контекст очищен до новой конфигурации
Strict Mode Оставь development Strict Mode включённым Setup/cleanup можно повторить без накопления эффекта
Preference Переключи OS reduce-motion и обнови страницу Содержание и действия доступны; несущественное движение уменьшено
Breakpoint Проверь узкий и широкий viewport и resize Селекторы и триггеры не остаются от старого состояния
Input Клавиатура, touch и обычный скролл Анимация не блокирует фокус и взаимодействие

Производительность нужно измерять

Начинай с небольшой области: убери ненужные бесконечные циклы, ограничь число одновременно движущихся слоёв и проверь, не вызывает ли чтение layout вперемешку с записями лишние пересчёты. Справка GSAP о gsap.to() описывает задержку некоторых записей до конца tick, чтобы уменьшать read/write thrashing; рекомендации по transform/opacity также встречаются в зафиксированных материалах GSAP о производительности. Это отправные точки для профилирования, не гарантия быстрого конкретного экрана: количество слоёв, фильтры, тени, размер поверхности и устройство всё равно имеют значение.

Сними профиль страницы на целевом телефоне и desktop viewport: посмотри layout/paint, пропущенные кадры, память и поведение при scroll. Сравни одинаковое действие до и после правки. Не пиши «60 FPS» на основании свойства CSS или библиотеки; это только измерение на конкретном сценарии и окружении. Для общего списка доступности смотри аудит доступного сайта; этот материал сосредоточен на React lifecycle и GSAP.

Как передать эту статью своему ИИ

В ZASLON Motion Kit есть навык zaslon-gsap-motion. Отправь ИИ URL этой статьи вместе с заданием:

Прочитай статью и https://github.com/mrakBH/zaslon-motion-kit/blob/main/INSTALL.md
Проверь анимацию моего React-компонента: scope, cleanup, reduced motion, смену маршрута и производительность. Исправь подтверждённые проблемы.
Используй навык zaslon-gsap-motion и мой бренд.
Если нужна установка, сначала объясни действия и получи моё согласие.
Мой проект и материалы: ...

Открыть навык на GitHub · Русская документация · English README. Ссылка передаёт инструкции, но сама не устанавливает файлы и не предоставляет доступ к проекту. Если у ИИ нет веба, передай SKILL.md из пакета вручную.