GSAPでアクセシブルなアニメーションを実装するためのガイド
matchMediaとprefers-reduced-motionを使った、アクセシブルなGSAPアニメーションの実装方法を解説。ScrollTriggerの簡素化や一時停止、動作設定のテストも紹介します。
GSAPでprefers-reduced-motionを扱う標準的な方法は、条件オブジェクトを渡したgsap.matchMedia()を使うことです。GSAPは、ユーザーのモーション設定に一致するセットアップ関数を実行します。ユーザーがその設定を変更すると、関数が作成したものをすべてリバートしてから再実行します。
多くのチームがこの手法にたどり着くのは、アクセシビリティ監査でスクロール連動でピン留めされるヒーローセクションやループするマーキーを指摘されたときです。デザイナーとしては、その修正のためにページを静的なPDFのようにはしたくありません。
メディアクエリのチェックは作業の一部にすぎません。アクセシブルなGSAP実装には、より穏やかなScrollTrigger、一時停止コントロール、スクリプトが実行されなくても表示されるコンテンツ、そしてそれらすべてをテストする方法も必要です。メディアクエリそのものの基礎知識が必要な場合は、OpenReplayのprefers-reduced-motionガイドを参照してください。なお、gsap.matchMedia()を使うにはGSAP 3.11.0以降が必要です。
重要なポイント
gsap.matchMedia()は、クエリが一致しなくなると、セットアップ関数内で作成したすべてのアニメーションとScrollTriggerをリバートします。そのため、OSの「視差効果を減らす」などのモーション軽減設定を変更すると、ページを再読み込みしなくても反映されます。- モーション軽減時は、大きな移動・回転・拡大縮小を短い不透明度のフェードに置き換えます。こうすることで、コンテンツは引き続き表示されます。
- モーション軽減用のScrollTriggerブランチでは
pinとscrubを外し、各要素がビューポートに入ったときにフェードインさせるだけにします。 - WCAG 2.2.2 一時停止、停止、非表示(レベルA)は、自動的に開始される動きに対して、一時停止・停止・非表示のいずれかのコントロールを求めています。prefers-reduced-motionのチェックだけでは、この基準を満たせません。
- アニメーション対象のコンテンツはデフォルトのCSS状態で読めるようにしておきます。そうすれば、アニメーションが実行されなくても
opacity: 0のまま残る要素はありません。
gsap.matchMedia()によるGSAPのprefers-reduced-motion分岐
gsap.matchMedia()は、クエリが一致している間だけセットアップ関数を実行します。クエリが一致しなくなると、その関数が作成したすべてのアニメーションとScrollTriggerをリバートします。クエリには条件オブジェクトを渡すこともできます。その場合、ハンドラーはcontext.conditionsから各条件をbooleanとして読み取ります。
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()をラップしているため、さらに別のcontextでラップする必要はありません。
モーション軽減時のScrollTriggerを穏やかにする
モーション軽減用のScrollTriggerブランチではpinと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は、トリガー要素がビューポートに入ったときにアニメーションを1回だけ再生します。これはフェードに適しています。手動でkillする必要はありません。設定が変更されると、matchMediaがピン留めされたタイムラインをリバートし、フェード版を構築します。フルモーション側のピン留めやスクラブのパターンについては、OpenReplayのScrollTriggerウォークスルーを参照してください。セッションリプレイを使うと、ユーザーがピン留めされたセクションを素早くスクロールで通り過ぎたり、アニメーションの途中で止まったりする様子を確認できます。そこから、どのモーションがユーザーの妨げになっているかを把握できます。
一時停止コントロールとページ内のモーション切り替え
WCAG 2.2.2 一時停止、停止、非表示はレベルAの達成基準です。自動的に開始され、5秒以上続き、ほかのコンテンツと並んで表示される動くコンテンツについて、一時停止・停止・非表示の手段を提供するよう求めています。prefers-reduced-motionに対応するだけではWCAG 2.2.2を満たせません。OSの設定を変更していないユーザーには、フルアニメーションがそのまま表示されるためです。また、W3Cの2.2.2解説書(Understanding)では、ページ内に動く、点滅する、スクロールする、または自動更新される要素が複数ある場合、それらすべてを制御する単一の仕組みを提供することを推奨しています。
| 達成基準 | レベル | GSAPでの実装手法 |
|---|---|---|
| 2.2.2 一時停止、停止、非表示 | A | timeline.pause() / timeline.play()を呼び出す一時停止ボタン |
| 2.3.3 インタラクションによるアニメーション | 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が表すルールは、「トグルでモーション軽減を追加することはできるが、OSによるモーション軽減の要求を上書きすることはできない」というものです。クリーンアップ関数ではリスナーの削除だけを行います。リバートはmatchMediaが自動的に処理するので、クリーンアップ関数内でcontext.revert()を呼び出さないでください。
アニメーションが実行されなくてもコンテンツを表示し続ける
アニメーション対象のコンテンツは、デフォルトの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()は、渡した値から要素の現在の状態に向かってアニメーションします。つまり、静止状態では要素は表示されたままで、要素が非表示になるのはアニメーション中だけです。不透明度と表示状態をまとめて扱うGSAPのプロパティautoAlphaでも同じです。CSSでopacity: 0とvisibility: hiddenを指定して非表示にしておき、トゥイーンで表示させるのを待つのではなく、autoAlpha: 0からアニメーションさせましょう。
要素が動く場合のフォーカス順序
x、y、scaleなどのGSAPのトランスフォームは、要素を視覚的に移動させますが、DOM上の位置は変わりません。そのため、キーボードフォーカスとスクリーンリーダーの読み上げ順序は、アニメーションではなくマークアップに従います。DOMは論理的な読み順に保ち、レイアウトプロパティをアニメーションさせて見かけ上の順序を偽装しないでください。
フォーカスを持っている要素を動かさないでください。また、インタラクティブな要素は、動きが落ち着く前にクリック可能にしないでください。カーソルの下をすり抜けていくボタンは、逃げていくターゲットになってしまいます。アニメーションするテキストについては、SplitTextがデフォルトでスクリーンリーダーに対応しています。aria: "auto"の場合、分割対象の要素にそのテキストを内容とするaria-labelを付与し、内部の行・単語・文字の要素にはaria-hiddenを付与します。これにより、アクセシビリティツリーには断片ではなく、読み取り可能な1つの文字列が公開されます。このデフォルトは見出しでは問題なく機能します。ただし、ARIAでは素の<div>、<span>、<p>のような汎用要素へのaria-labelの使用が禁止されており、アクセシビリティチェッカーでも指摘されます。こうした要素の場合や、分割したテキスト内に読み上げが必要なリンクがネストされている場合は、ARIA属性を一切付与しないaria: "none"を使い、スクリーンリーダー専用のテキストのコピーを用意してください。
GSAPでモーション軽減をテストするには?
ページを開いたままモーション軽減の設定を切り替えて、GSAPの両方のモーションブランチをテストします。gsap.matchMedia()は設定の変更に反応するため、再読み込みしなくてもアニメーションが切り替わるはずです。OSのモーション軽減設定をオンにするか(各プラットフォームでの設定場所については、MDNのprefers-reduced-motionのユーザー設定を参照してください)、Chromeでエミュレートします。Chrome DevToolsでは、Renderingタブを開いて「Emulate CSS media feature prefers-reduced-motion」を探し、prefers-reduced-motion: reduceを選択します。
以下の点を確認してください。
- ピン留めされていたセクションがピン留めされなくなっている。
- ループする動きがなくなっているか、キーボードで操作できる一時停止ボタンが正しく機能する。
- JavaScriptを無効にしても、すべてのコンテンツが表示される。
- ページ内のトグルで、アニメーションが即座に再構築される。
まとめ
アクセシブルなGSAP実装では、デザインを維持しつつ、その制御をユーザーに委ねます。matchMediaで大きな動きをフェードに置き換えてOSの設定と同期させ、軽減用ブランチではScrollTriggerのピン留めをやめ、長く続く動きは実際のボタンで一時停止できるようにし、JavaScriptがなくてもコンテンツが表示されるようにします。まずは監査で指摘されたピン留めやループのアニメーションから着手し、その軽減用ブランチと一時停止コントロールを実装して、DevToolsのエミュレーションで両方をテストしてから次のアニメーションに進みましょう。
よくある質問
Reactでモーション軽減のためにgsap.matchMedia()を使うにはどうすればよいですか?
エフェクト内でmatchMediaインスタンスを作成し、mm.revert()を呼び出すクリーンアップ関数を返します。インスタンスをリバートすると、そのハンドラーが作成したすべてのアニメーションとScrollTriggerがリバートされるため、別途gsap.context()を使う必要はありません。React Strict Modeではコンポーネントのマウント、アンマウント、再マウントが行われるため、開発時にはこのクリーンアップが重要です。クリーンアップがないと、同じアニメーションが2回開始される可能性があります。
CSSのprefers-reduced-motionリセットでGSAPのアニメーションは止まりますか?
いいえ。prefers-reduced-motion: reduceブロック内でアニメーションやトランジションの再生時間を短くするグローバルなCSSルールは、CSSアニメーションと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