Руководство по доступной анимации в GSAP
Создавайте доступные анимации GSAP с matchMedia и prefers-reduced-motion. Упрощайте эффекты ScrollTrigger, добавляйте паузу и проверяйте настройки движения.
Стандартный способ учесть prefers-reduced-motion в GSAP — gsap.matchMedia() с объектом условий. GSAP запускает функцию настройки для того предпочтения по движению, которое сейчас совпадает. Когда пользователь меняет эту настройку, GSAP откатывает всё, что создала функция, и запускает её заново.
Обычно команды приходят к этому после аудита доступности, который указал на hero-блок с закреплением при прокрутке или бесконечную бегущую строку, а дизайнеры не хотят превращать страницу в статичный PDF ради исправления.
Проверка медиазапроса — лишь часть работы. Доступная настройка GSAP также требует более спокойных ScrollTrigger, кнопки паузы, контента, который остаётся видимым, даже если скрипт не запустится, и способа всё это протестировать. Подробнее о самом медиазапросе читайте в руководстве OpenReplay по prefers-reduced-motion. Для gsap.matchMedia() нужна версия GSAP 3.11.0 или новее.
Ключевые выводы
gsap.matchMedia()откатывает все анимации и ScrollTrigger, созданные в функции настройки, когда её запрос перестаёт совпадать. Поэтому изменение системной настройки уменьшения движения применяется без перезагрузки страницы.- В режиме уменьшенного движения замените крупные перемещения, вращение и масштабирование короткой анимацией прозрачности, чтобы контент всё равно появлялся.
- Ветка ScrollTrigger для уменьшенного движения должна отказаться от
pinиscrubи просто плавно проявлять каждый элемент при его попадании в область просмотра. - Критерий WCAG 2.2.2 «Пауза, остановка, скрытие» (уровень A) требует элемента управления для паузы, остановки или скрытия автоматического движения. Одной лишь проверки prefers-reduced-motion для этого недостаточно.
- Оставляйте анимируемый контент читаемым в его исходном CSS-состоянии, чтобы ничего не застревало в
opacity: 0, если анимация не запустится.
Ветвление по prefers-reduced-motion в GSAP с помощью gsap.matchMedia()
gsap.matchMedia() выполняет функцию настройки только пока её запрос совпадает. Когда запрос перестаёт совпадать, он откатывает все анимации и ScrollTrigger, созданные функцией. В качестве запроса можно передать объект условий — тогда обработчик получает каждое условие как булево значение из context.conditions.
const mm = gsap.matchMedia();
const conditions = {
isMotion: "(prefers-reduced-motion: no-preference)",
isReduced: "(prefers-reduced-motion: reduce)",
};
mm.add(conditions, (context) => {
const { isMotion, isReduced } = context.conditions;
if (isMotion) {
gsap.from(".hero-card", { opacity: 0, x: -200, rotation: -8, duration: 1 });
}
if (isReduced) {
gsap.from(".hero-card", { opacity: 0, duration: 0.4 });
}
});
Стремитесь уменьшить движение, а не убрать его полностью. В ветке для уменьшенного движения крупное горизонтальное перемещение и вращение превращаются в короткое проявление. Карточка по-прежнему появляется и привлекает к себе внимание, но ничего не проносится по экрану. В руководстве GSAP по доступной анимации приведены критерии, когда анимацию стоит упростить, а когда — убрать совсем. matchMedia() внутри оборачивает gsap.context(), поэтому не заворачивайте его в ещё один контекст.
Как успокоить ScrollTrigger для уменьшенного движения
Ветка ScrollTrigger для уменьшенного движения должна отказаться от pin и scrub и плавно проявлять каждый элемент при попадании в область просмотра. Закрепление перехватывает прокрутку пользователя, а scrub привязывает движение к каждому жесту прокрутки. Именно этого ветка для уменьшенного движения и должна избегать.
mm.add(conditions, (context) => {
if (context.conditions.isMotion) {
const tl = gsap.timeline({
scrollTrigger: { trigger: ".story", pin: true, scrub: 1, end: "+=200%" },
});
tl.from(".story-step", { opacity: 0, y: 100, stagger: 0.5 });
} else {
gsap.utils.toArray(".story-step").forEach((step) => {
gsap.from(step, { opacity: 0, duration: 0.4, scrollTrigger: { trigger: step } });
});
}
});
В простейшем виде ScrollTrigger проигрывает анимацию один раз — когда элемент-триггер попадает в область просмотра. Для проявления это то, что нужно. Ничего не придётся уничтожать вручную: если предпочтение изменится, matchMedia откатит закреплённый таймлайн и построит версию с проявлением. Паттерны закрепления и scrub для режима полного движения разобраны в пошаговом руководстве OpenReplay по ScrollTrigger. Записи сессий (session replay) могут показать, как пользователи быстро проматывают закреплённые секции или останавливаются посреди анимации, — это указывает, где движение им мешает.
Кнопки паузы и переключатель движения на странице
WCAG 2.2.2 «Пауза, остановка, скрытие» — критерий уровня A, который требует способа приостановить, остановить или скрыть движущийся контент, если он запускается автоматически, длится более пяти секунд и отображается рядом с другим контентом. Учёт prefers-reduced-motion не удовлетворяет WCAG 2.2.2, потому что пользователи, не менявшие системную настройку, по-прежнему видят полную анимацию. В пояснительном документе W3C к критерию 2.2.2 также рекомендуется: если на странице больше одного движущегося, мигающего, прокручивающегося или автоматически обновляемого элемента, предоставьте единый механизм, управляющий ими всеми.
| Критерий | Уровень | Техника в GSAP |
|---|---|---|
| 2.2.2 Pause, Stop, Hide | A | Кнопка паузы, вызывающая timeline.pause() / timeline.play() |
| 2.3.3 Animation from Interactions | AAA | Ветка уменьшенного движения в gsap.matchMedia() |
WCAG 2.2.2 и 2.3.3 касаются разного движения. 2.3.3 относится к движению, вызванному действиями пользователя, а 2.2.2 — к движению, которое страница запускает сама. Более широкий обзор рекомендаций — в обзоре доступной анимации от OpenReplay.
const toggle = document.querySelector("#reduce-motion");
const pauseBtn = document.querySelector("#pause-motion");
toggle.checked = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
toggle.addEventListener("change", gsap.matchMediaRefresh);
mm.add(conditions, (context) => {
const reduce = context.conditions.isReduced || toggle.checked;
pauseBtn.hidden = reduce;
if (reduce) return; // marquee stays static
const tl = gsap.timeline({ repeat: -1 });
tl.to(".marquee-track", { xPercent: -50, duration: 20, ease: "none" });
pauseBtn.textContent = "Pause animation";
const onClick = () => {
tl.paused() ? tl.play() : tl.pause();
pauseBtn.textContent = tl.paused() ? "Play animation" : "Pause animation";
};
pauseBtn.addEventListener("click", onClick);
return () => pauseBtn.removeEventListener("click", onClick);
});
pause() приостанавливает экземпляр и при необходимости может перейти к заданному моменту времени. Без аргумента он останавливается там, где сейчас находится указатель воспроизведения. play() продолжает воспроизведение с этой точки и гарантирует, что экземпляр не приостановлен и не проигрывается в обратную сторону. paused() без аргумента работает как геттер, поэтому его удобно использовать для переключения.
gsap.matchMediaRefresh() откатывает все активные настройки matchMedia и заново запускает те, что по-прежнему совпадают, поэтому чекбокс мгновенно перестраивает все анимации. Правило в reduce = isReduced || toggle.checked таково: переключатель может добавить уменьшение движения, но никогда не отменяет системный запрос на уменьшенное движение. Функция очистки лишь удаляет обработчик события. Не вызывайте в ней context.revert() — откат matchMedia выполняет сам.
Контент остаётся видимым, даже если анимация не запустилась
Анимируемый контент должен быть полностью читаемым в исходном CSS-состоянии. Тогда, если скрипт упадёт или ни одна ветка matchMedia не выполнится, ничего не останется в opacity: 0 или visibility: hidden. Такое действительно случается: обработчик gsap.matchMedia() на основе объекта условий вообще не запускается, если ни одно из условий не совпало.
/* Avoid: content is invisible until JavaScript reveals it */
.reveal { opacity: 0; }
// Prefer: CSS leaves .reveal visible; GSAP animates from hidden to that state
mm.add(conditions, () => {
gsap.from(".reveal", { opacity: 0, duration: 0.4 });
});
gsap.from() анимирует от переданных значений к текущему состоянию элемента. Это значит, что состояние покоя остаётся видимым, а скрывает элемент только сама анимация. То же касается autoAlpha — комбинированного свойства GSAP для прозрачности и видимости: анимируйте контент от autoAlpha: 0, а не прячьте его в CSS через opacity: 0 и visibility: hidden в ожидании, что твин его покажет.
Порядок фокуса при перемещении элементов
Трансформации GSAP, такие как x, y и scale, визуально смещают элемент, но не меняют его позицию в DOM. Поэтому фокус клавиатуры и порядок чтения скринридером следуют разметке, а не анимации. Поддерживайте логичный порядок чтения в DOM и не анимируйте свойства раскладки, чтобы имитировать другой порядок.
Не перемещайте элемент, пока он в фокусе, и не делайте интерактивный элемент кликабельным, пока он не встал на место. Кнопка, выезжающая из-под курсора, — это ускользающая цель. Для анимированного текста SplitText по умолчанию заботится о скринридерах. С aria: "auto" он добавляет разбиваемому элементу aria-label, заполненный его текстом, а вложенным элементам строк, слов и символов — aria-hidden. Так дерево доступности предоставляет одну читаемую строку вместо отдельных фрагментов. Это поведение по умолчанию подходит для заголовков, но ARIA запрещает aria-label на элементах без семантики, таких как обычные <div>, <span> или <p>, и инструменты проверки доступности отмечают это как ошибку. Для таких элементов, а также если разбиваемый текст содержит вложенные ссылки, которые должны озвучиваться, используйте aria: "none" — этот режим не добавляет атрибутов ARIA — и предоставьте копию текста, видимую только скринридерам.
Как тестировать уменьшенное движение в GSAP?
Тестируйте обе ветки движения GSAP, переключая предпочтение уменьшенного движения при открытой странице. Поскольку gsap.matchMedia() реагирует на изменения, анимации должны смениться без перезагрузки. Включите системную настройку уменьшения движения (где она находится на каждой платформе, см. раздел MDN о пользовательских настройках prefers-reduced-motion) или эмулируйте её в Chrome. В Chrome DevTools откройте вкладку Rendering, найдите «Emulate CSS media feature prefers-reduced-motion» и выберите prefers-reduced-motion: reduce.
Проверьте следующее:
- Закреплённые секции больше не закрепляются.
- Зацикленное движение либо исчезло, либо имеет работающую кнопку паузы, доступную с клавиатуры.
- При отключённом JavaScript весь контент по-прежнему виден.
- Переключатель на странице мгновенно перестраивает анимации.
Заключение
Доступная настройка GSAP сохраняет дизайн и даёт пользователям контроль над ним. matchMedia заменяет крупные перемещения проявлением и синхронизируется с системной настройкой, ScrollTrigger перестаёт закреплять секции в ветке уменьшенного движения, настоящая кнопка приостанавливает всё продолжительное, а контент остаётся видимым без JavaScript. Начните с закреплённой или зацикленной анимации, на которую указал аудит, напишите для неё ветку уменьшенного движения и кнопку паузы и проверьте обе с помощью эмуляции в DevTools, прежде чем переходить к следующей.
Часто задаваемые вопросы
Как использовать gsap.matchMedia() для уменьшенного движения в React?
Создавайте экземпляр matchMedia внутри эффекта и возвращайте функцию очистки, которая вызывает mm.revert(). Откат экземпляра откатывает все анимации и ScrollTrigger, созданные его обработчиками, поэтому отдельный gsap.context() не нужен. Очистка важна в режиме разработки: React Strict Mode монтирует, размонтирует и повторно монтирует компоненты, из-за чего без неё одна и та же анимация может запуститься дважды.
Останавливает ли CSS-сброс для prefers-reduced-motion анимации GSAP?
Нет. Глобальное CSS-правило, сокращающее длительность анимаций и переходов внутри блока prefers-reduced-motion: reduce, влияет только на CSS-анимации и переходы. GSAP анимирует из JavaScript, записывая инлайн-стили на каждом кадре, поэтому его твины и ScrollTrigger продолжают работать. Управляйте движением GSAP через ветку уменьшенного движения в gsap.matchMedia(), а CSS-сброс оставьте для движения на CSS.
Что происходит с выполняющейся анимацией GSAP, когда пользователь меняет настройку уменьшенного движения?
gsap.matchMedia() откатывает её и заново запускает обработчик для нового предпочтения. Откат удаляет инлайн-стили, добавленные анимациями, и откатывает ScrollTrigger, созданные в обработчике, включая их закрепление. Затем вновь совпавшая ветка строит свои анимации с нуля, поэтому недоигранный твин полного движения не возобновляется. Версия с уменьшенным движением начинается от исходного CSS-состояния элемента.
Gain Debugging Superpowers
Unleash the power of session replay to reproduce bugs, track slowdowns and uncover frustrations in your app. Get complete visibility into your frontend with OpenReplay — the most advanced open-source session replay tool for developers.
Star on GitHub12k