GSAP в Next.js: когда CSS достаточно, а когда нужна библиотека анимации
GSAP - JavaScript-библиотека для программной анимации DOM-элементов, SVG и числовых значений. Позволяет управлять отдельными анимациями и объединять их в последовательности с помощью таймлайнов.
Прямой ответ: для hover, простых переходов и одиночных появлений достаточно CSS. GSAP практичнее, когда появляется логика управления - связанные последовательности с динамическим временем, синхронизация нескольких объектов, сложные скролл-сцены с закреплением, движение по траектории или переходы между состояниями DOM.
Чем GSAP отличается от CSS по модели управления
CSS задает анимацию декларативно: через свойства, переходы и ключевые кадры. В @keyframes доступны промежуточные кадры, задержки и несколько анимаций на одном элементе.
GSAP предоставляет программный API для управления отдельными анимациями и их последовательностями: позволяет динамически менять параметры, синхронизировать несколько объектов, управлять воспроизведением и привязывать прогресс к действиям пользователя.
gsap.from(".hero-title", {
y: 60,
opacity: 0,
duration: 1,
ease: "power3.out"
});
Здесь y: 60 - стартовое смещение по вертикали, opacity: 0 - стартовая прозрачность, duration: 1 - длительность в секундах, ease - кривая скорости. Для одиночной анимации таймлайн не нужен, достаточно to, from или fromTo. GSAP рассчитывает промежуточные значения и обновляет свойства через собственный ticker, использующий requestAnimationFrame в браузере.
Что спокойно закрывает CSS
CSS остается лучшим выбором для простых локальных эффектов:
- hover и focus-состояния кнопок, ссылок, карточек
- простые переходы
transitionпо цвету, фону, тени - одиночное появление блока через класс и
@keyframes - простые бесконечные декоративные анимации - вращение, пульсация
- простые анимации, привязанные к прокрутке, без JavaScript
Последний пункт стоит пояснить отдельно. CSS Scroll-driven Animations позволяют привязывать прогресс CSS-анимации к прокрутке через scroll() и view() timelines. Статус Baseline Newly available присвоен 27 октября 2026 года, то есть возможность доступна в актуальных браузерах, но поведение в старых версиях стоит проверять отдельно. Для проектов с требованиями к широкой совместимости следует предусмотреть статичное состояние или альтернативную анимацию. Документация - MDN: CSS Scroll-driven Animations.
Где практичнее GSAP
1. Связанные последовательности с управлением временем
Timeline позволяет выстроить порядок без ручного подсчета задержек и менять его из кода:
const tl = gsap.timeline({ defaults: { ease: "power3.out" } });
tl.from(".hero-title", { y: 40, opacity: 0, duration: 0.7 })
.from(".hero-text", { y: 24, opacity: 0, duration: 0.6 }, "-=0.4")
.from(".hero-button", { y: 16, opacity: 0, duration: 0.5 }, "-=0.35");
Второй и третий шаги стартуют до конца предыдущего. В CSS тот же нахлест описывается задержками вручную, при правке одной длительности приходится пересчитывать остальные. В GSAP timeline можно ставить на паузу, разворачивать, ускорять и перестраивать.
2. Сложные скролл-сцены
CSS Scroll-driven Animations закрывают простые случаи: появление по мере входа в вьюпорт, прогресс-бар чтения, параллакс с линейной привязкой к скроллу.
ScrollTrigger дает более гибкий API для сложных сценариев: закрепление секций (pin), привязка прогресса анимации к прокрутке (scrub) с возможностью сглаживания изменения прогресса, точки притяжения (snap), управление несколькими связанными анимациями в одной сцене, обратное воспроизведение и точная синхронизация объектов. Документация ядра и React-интеграции - GSAP Documentation, GSAP + React.
3. SVG, траектории, состояния интерфейса
| Инструмент | Назначение | Когда выбирать |
|---|---|---|
| GSAP Core | отдельные анимации, таймлайны, easing | последовательности с динамическим управлением временем |
| ScrollTrigger | pin, scrub, snap, сцены по скроллу | сложные скролл-сцены с закреплением и синхронизацией |
| MotionPath | движение по кривой | объект идет по заданной траектории |
| MorphSVG | изменение геометрии SVG path | плавное превращение одной векторной формы в другую |
| Flip | переход между двумя состояниями DOM | перестройка сетки, смена раскладки, фильтры каталога |
| Draggable | перетаскивание | слайдеры, конструкторы, интерактивные панели |
| SplitText | разбивка текста на символы и строки | посимвольное появление заголовка |
Плагины GSAP и хук useGSAP рекомендуется регистрировать через gsap.registerPlugin(). В таблице выше показаны только названия инструментов, без кода подключения каждого из них.
import gsap from "gsap";
import { ScrollTrigger } from "gsap/ScrollTrigger";
gsap.registerPlugin(ScrollTrigger);
В проектах со сборщиками регистрацию не стоит пропускать: она связывает плагин с GSAP и предотвращает проблемы с tree-shaking при production-сборке. Полный список - GSAP Plugins.
MotionPath отвечает за движение вдоль пути, MorphSVG - за изменение самой формы. Это разные задачи, один инструмент другим не заменяется.
GSAP в React и Next.js
GSAP работает с DOM напрямую, поэтому в React важно учитывать жизненный цикл компонентов и область действия анимаций. Глобальные селекторы могут затрагивать элементы за пределами компонента, а неочищенные анимации продолжать работу после его размонтирования. Для управления контекстом и очистки удобнее использовать @gsap/react с хуком useGSAP().
Установка:
npm install gsap @gsap/react
Шаблон использования:
"use client";
import { useRef } from "react";
import gsap from "gsap";
import { useGSAP } from "@gsap/react";
gsap.registerPlugin(useGSAP);
export default function Hero() {
const root = useRef(null);
useGSAP(() => {
gsap.from(".hero-title", {
y: 60,
opacity: 0,
duration: 1,
ease: "power3.out"
});
}, { scope: root });
return (
<section ref={root}>
<h1 className="hero-title">
Заголовок первого экрана
</h1>
</section>
);
}
Параметр scope ограничивает область поиска селекторов текущим компонентом, хук сам очищает анимации при размонтировании. Регистрация useGSAP рекомендована документацией GSAP. Для анимаций в обработчиках событий, которые создаются после первого выполнения хука, дополнительно используют contextSafe().
GSAP инициализируется в клиентском компоненте после его монтирования. При этом остальная часть страницы может оставаться серверной: достаточно вынести анимируемый участок в отдельный компонент с директивой use client. Превращать всю страницу в Client Component ради визуального эффекта не требуется.
Проверка актуальности: поведение описано по документации GSAP и пакета @gsap/react, ноябрь 2026. Перед стартом проекта стоит сверить API с текущей версией.
Ограничения и производительность
GSAP - зависимость с весом и ценой поддержки. Библиотека не улучшает слабую композицию и не ускоряет загрузку сама по себе.
Для производительности предпочтительно анимировать transform и opacity: такие изменения во многих случаях обрабатываются на этапе композиции слоев. Анимация filter, box-shadow и других свойств, требующих перерисовки, может быть дороже в зависимости от площади эффекта, числа объектов и частоты обновления. Результат необходимо проверять в профилировщике браузера на целевых устройствах. will-change применяют только после выявления конкретной проблемы, а не заранее: избыточные слои увеличивают потребление памяти.
Ориентир для выбора:
| Задача | Что выбрать |
|---|---|
| Hover, focus, простые переходы | CSS |
| Одиночное появление блока | CSS |
| Простая декоративная анимация | CSS |
| Последовательность с динамическим управлением временем | GSAP |
| Синхронизация нескольких объектов | GSAP |
| Простая scroll-driven анимация | CSS |
| Сложные скролл-сцены с pin, scrub и snap | GSAP |
| Переходы между состояниями DOM | GSAP Flip |
| Морфинг SVG | GSAP MorphSVG |
