Короткий ответ: в 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 из пакета вручную.
