Главная / Блог / GSAP в Next.js

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последовательности с динамическим управлением временем
ScrollTriggerpin, 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 и snapGSAP
Переходы между состояниями DOMGSAP Flip
Морфинг SVGGSAP MorphSVG

Частые вопросы

Чтобы не пропустить новые материалы

Короткий дайджест вечером в понедельник. Без спама.

Выберите, что получать

Обсудим ваш проект

Расскажите о вашем бизнесе, покажите текущий сайт или просто опишите задачу в свободной форме. Я изучу вводные, предложу решение и сориентирую по срокам и смете.

Отвечаю в течение нескольких часов в рабочее время.

Защита от спама – Yandex SmartCaptcha

Если вам удобнее обсудить всё текстом без заполнения форм – напишите напрямую: в Telegram или на sergei@kruglov.net

Удобнее голосом? Напишите пару слов о задаче - договоримся об удобном времени созвона на 15-20 минут, и я пришлю свой номер телефона.