【GSAP】gsap.matchMedia() の使い方!レスポンシブ対応から自動リセット・クリーンアップ関数活用テクニック
- 1. デモ動作
- 2. 実装コード紹介
- 2.1. 【HTML】
- 2.2. 【CSS】
- 2.3. 【JavaScript】
- 3. gsap.matchMedia()の仕組みと応用テクニック
- 3.1. 基本の書き方と context.conditions によるスマートな分岐
- 3.2. PC/SPの画面幅だけじゃない!条件指定応用編
- 3.2.1. アクセシビリティ対応:prefers-reduced-motion
- 3.2.2. マウスホバー対応デバイスの判定:(hover: hover)
- 3.3. 最大のメリット!条件から外れた時の「自動リセット(revert)」機能
- 3.4. クリーンアップ関数(return () => {})はいつ使う?
- 3.5. 補足:公式ドキュメント
- 4. まとめ
WebサイトにGSAPでアニメーションを実装する際、「PC画面では大きく横に動かしたいけれど、スマホ画面では縦に小さく動かしたい(またはアニメーション自体を無効にしたい)」といったレスポンシブ対応が必要になる場面は非常に多いですよね。
そんな時に活躍するのが、GSAP v3.11から導入された gsap.matchMedia() です! CSSのメディアクエリと同じ感覚で条件分岐ができるだけでなく、「画面幅が切り替わった時に、古いアニメーションやScrollTriggerを自動で破棄して初期状態に戻してくれる(自動リセット)」という便利な機能が備わっています。
今回は、基本的なPC・SPの分岐方法から、アクセシビリティ対応(視差効果の制御)などの一歩進んだ使い道、さらに独自のイベントリスナーを片付ける「クリーンアップ関数」の書き方まで、動きが確認できるデモと一緒に解説します!
デモ動作
See the Pen GSAPの gsap.matchMedia() の使い方! by mikanbako (@mikanbako) on CodePen.
demo: gsap.matchMedia() の使い方!レスポンシブ対応から自動リセット・クリーンアップ関数まで
実装コード紹介
【HTML】
<div class="l-wrap">
<h2>gsap.matchMedia() 動作&クリーンアップ確認デモ</h2>
<p class="p-desc">ウィンドウ幅を変えると、アニメーションと登録イベントが自動で切り替わります!</p>
<div class="p-demo-box">
<!-- 現在の判定ステータス表示 -->
<div class="c-status-bar">
<div class="c-badge js-mode-badge">判定中...</div>
<div class="c-width-info">現在の画面幅: <strong class="js-width-val">0</strong>px <small>(境界: 600px)</small></div>
</div>
<!-- アニメーションのステージ -->
<div class="c-stage">
<div class="c-box js-box">
<span class="c-box__label js-box-label">BOX</span>
<small class="c-box__sub">クリックで+<span class="js-click-count">0</span></small>
</div>
</div>
<!-- 実行ログ(自動リセット&クリーンアップの確認用) -->
<div class="p-log-area">
<div class="c-log-header">
<span>📋 matchMedia 実行&クリーンアップ履歴</span>
<button class="c-btn-clear js-clear-log">ログ消去</button>
</div>
<ul class="c-log-list js-log-list"></ul>
</div>
</div>
</div>
【CSS】
/* ベース装飾 */
.l-wrap {
padding: 30px 15px;
max-width: 650px;
margin: 0 auto;
color: #3e3e3e;
text-align: center;
}
h2 {
margin-bottom: 10px;
font-size: 16px;
color: #1bb4d4;
}
.p-desc {
margin-bottom: 20px;
font-size: 16px;
font-weight: bold;
line-height: 1.6;
color: #666;
}
.p-demo-box {
padding: 25px;
text-align: left;
background: #fff;
border-radius: 12px;
box-shadow: 0 4px 15px rgb(0 0 0 / 5%);
}
/* ステータスバー */
.c-status-bar {
display: flex;
flex-wrap: wrap;
gap: 10px;
align-items: center;
justify-content: space-between;
padding: 12px 15px;
margin-bottom: 20px;
background: #f8f9fa;
border: 1px solid #e9ecef;
border-radius: 8px;
}
.c-badge {
padding: 8px 14px;
font-size: 14px;
font-weight: bold;
color: #fff;
background: #6c757d;
border-radius: 20px;
transition: 0.3s;
}
.c-badge.is-pc {
background: #1bb4d4;
}
.c-badge.is-sp {
background: #e83e8c;
}
.c-width-info {
font-size: 14px;
font-weight: bold;
color: #555;
}
.c-width-info strong {
font-family: monospace;
font-size: 18px;
color: #333;
}
/* ステージとボックス */
.c-stage {
display: flex;
align-items: center;
justify-content: center;
height: 180px;
margin-bottom: 20px;
overflow: hidden;
background: #f0f4f8;
border: 2px dashed #cbd5e1;
border-radius: 8px;
}
.c-box {
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
width: 90px;
height: 90px;
font-weight: bold;
color: #fff;
cursor: pointer;
user-select: none;
background: #333;
border-radius: 12px;
box-shadow: 0 6px 15px rgb(0 0 0 / 15%);
}
.c-box__label {
margin-bottom: 4px;
font-size: 14px;
}
.c-box__sub {
padding: 2px 8px;
font-size: 12px;
background: rgb(255 255 255 / 20%);
border-radius: 10px;
}
/* ログ表示エリア */
.p-log-area {
padding: 15px;
font-family: monospace;
color: #f8f8f2;
background: #272822;
border-radius: 8px;
}
.c-log-header {
display: flex;
align-items: center;
justify-content: space-between;
padding-bottom: 8px;
margin-bottom: 10px;
font-size: 14px;
font-weight: bold;
color: #a6e22e;
border-bottom: 1px solid #444;
}
.c-btn-clear {
padding: 4px 10px;
font-size: 12px;
color: #fff;
cursor: pointer;
background: #555;
border-radius: 4px;
}
.c-btn-clear:hover {
background: #777;
}
.c-log-list {
max-height: 130px;
overflow-y: auto;
font-size: 13px;
line-height: 1.6;
}
.c-log-list li {
padding: 3px 0;
border-bottom: 1px dashed #3b3c35;
}
.u-log-setup {
color: #66d9ef;
}
.u-log-clean {
font-weight: bold;
color: #ff79c6;
}
【JavaScript】
const box = document.querySelector('.js-box');
const boxLabel = document.querySelector('.js-box-label');
const modeBadge = document.querySelector('.js-mode-badge');
const widthVal = document.querySelector('.js-width-val');
const clickCountEl = document.querySelector('.js-click-count');
const logList = document.querySelector('.js-log-list');
// 画面上にログを追加する補助関数
const addLog = (message, type = 'setup') => {
const li = document.createElement('li');
li.className = type === 'clean' ? 'u-log-clean' : 'u-log-setup';
li.textContent = message;
logList.prepend(li);
};
document.querySelector('.js-clear-log').addEventListener('click', () => {
logList.innerHTML = '';
});
// 現在の画面幅を表示更新
const updateWidth = () => { widthVal.textContent = window.innerWidth; };
window.addEventListener('resize', updateWidth);
updateWidth();
// =========================================
// 💡 gsap.matchMedia() の実装
// =========================================
const mm = gsap.matchMedia();
mm.add({
// 1. 名前付きで複数の条件(メディアクエリ)を定義!
isDesktop: '(width >= 600px)',
isMobile: '(width < 600px)',
reduceMotion: '(prefers-reduced-motion: reduce)' // 視差効果を減らす設定の検知
}, (context) => {
// 2. context.conditions から各条件の true / false を取り出す
const { isDesktop, isMobile, reduceMotion } = context.conditions;
const modeName = isDesktop ? '💻 PCモード (600px以上)' : '📱 SPモード (599px以下)';
// ステータス表示の更新
modeBadge.textContent = modeName;
modeBadge.className = `c-badge ${isDesktop ? 'is-pc' : 'is-sp'}`;
boxLabel.textContent = isDesktop ? 'PC BOX' : 'SP BOX';
addLog(`▶ [${modeName}] のアニメーションとイベントを登録しました`);
// 💡 条件に応じたアニメーションの分岐
if (reduceMotion) {
// OSで「動きを減らす」設定がONの時は、激しい移動をせずフェードのみにする(アクセシビリティ配慮)
gsap.to(box, { opacity: 0.6, duration: 1, repeat: -1, yoyo: true });
} else if (isDesktop) {
// PC用:左右に大きく移動しながら回転し、背景色をブルーにする
gsap.to(box, {
x: 140,
rotation: 360,
backgroundColor: '#1bb4d4',
duration: 2,
repeat: -1,
yoyo: true,
ease: 'power1.inOut'
});
} else if (isMobile) {
// SP用:横幅が狭いため、上下のバウンドと拡大縮小にし、背景色をピンクにする
gsap.to(box, {
y: -35,
scale: 1.15,
backgroundColor: '#e83e8c',
duration: 0.8,
repeat: -1,
yoyo: true,
ease: 'sine.inOut'
});
}
// 💡 独自のイベントリスナー(GSAP外の処理)の登録例
let count = 0;
clickCountEl.textContent = count;
const handleClick = () => {
count++;
clickCountEl.textContent = count;
gsap.fromTo(box, { scale: 1.3 }, { scale: 1, duration: 0.3 });
};
box.addEventListener('click', handleClick);
// 💡 3. クリーンアップ関数(条件から外れた瞬間に自動で実行される!)
return () => {
// GSAPのアニメーションは自動で revert(破棄&初期化)されますが、
// 自分で追加したイベントリスナーやクラス変更などはここで後片付けします!
box.removeEventListener('click', handleClick);
addLog(`🧹 クリーンアップ実行![${modeName}] のアニメーション破棄&クリックイベントを解除しました`, 'clean');
};
});
gsap.matchMedia()の仕組みと応用テクニック
基本の書き方と context.conditions によるスマートな分岐
gsap.matchMedia() を使う際は、単一のメディアクエリを書くこともできますが、複数の条件に名前をつけてオブジェクトとして登録し、context.conditions から真偽値(true / false)を取り出して分岐させる書き方が最もよく使われます。
const mm = gsap.matchMedia();
mm.add({
isPC: '(width >= 768px)',
isSP: '(width < 768px)'
}, (context) => {
// 分割代入でそれぞれの判定結果(true / false)を取得
const { isPC, isSP } = context.conditions;
// PCとSPで移動距離だけをスマートに変えることも可能!
gsap.to('.box', {
x: isPC ? 300 : 100, // PCなら300px、SPなら100px移動
duration: 1
});
});
このように書けば、アニメーションのコードを2回書く必要がなく、三項演算子(isPC ? PCの値 : SPの値)を使って1つのTweenの中で数値だけを出し分けるといったスマートな記述が可能になります!
PC/SPの画面幅だけじゃない!条件指定応用編
CSSのメディアクエリで使える条件なら何でも指定できます。画面幅以外に、特に重宝するのが以下の2つです!
アクセシビリティ対応:prefers-reduced-motion
OSやブラウザの設定で「視差効果を減らす(アニメーションを抑制する)」をONにしているユーザーを検知できます。激しい移動や回転を控え、シンプルなフェード表示に切り替えるといった優しい設計が簡単に作れます。
mm.add({
isPC: '(width >= 768px)',
reduceMotion: '(prefers-reduced-motion: reduce)'
}, (context) => {
const { isPC, reduceMotion } = context.conditions;
if (reduceMotion) return; // 動きを減らす設定の時はアニメーションさせない!
// 通常のアニメーション処理...
});
マウスホバー対応デバイスの判定:(hover: hover)
「マウスでホバーできる端末(PC)の時だけ、マウスストーカーやホバー演出を有効にし、タッチ端末では動かさない」といった分岐にも使えます。
最大のメリット!条件から外れた時の「自動リセット(revert)」機能
もし gsap.matchMedia() を使わずに普通の window.matchMedia や resize イベントでアニメーションを切り替えた場合、PC用で動いていたアニメーションのインラインスタイル(transform: translate(140px, 0px) など)が要素に残り続けてしまい、SP用のアニメーションと競合して表示が崩れてしまいます。
しかし gsap.matchMedia() の関数内で作られたGSAPアニメーションや ScrollTrigger は、条件(画面幅など)が切り替わった瞬間にすべて自動的に破棄(revert())され、HTML要素のスタイルもアニメーション前の初期状態へ綺麗さっぱりリセットされます! この「自分でリセット処理を書かなくていい」という点こそが、gsap.matchMedia() を使う最大のメリットです。
クリーンアップ関数(return () => {})はいつ使う?
GSAPのアニメーションやScrollTriggerは自動でリセットされますが、「GSAP以外の通常のJavaScript処理」は自動では元に戻りません。 例えば、特定の画面幅の時だけ addEventListener でクリックイベントを登録したり、classList.add() でクラスを付与した場合は、関数の最後に return () => { ... }(クリーンアップ関数) を書いておくと、条件から外れた瞬間にその中身を自動実行してくれます!
mm.add('(width >= 768px)', () => {
// PC画面の時だけクリックイベントを登録
const onClick = () => console.log('PCでクリックされました');
window.addEventListener('click', onClick);
// 💡 768px未満になった瞬間に自動で呼ばれるクリーンアップ関数!
return () => {
window.removeEventListener('click', onClick); // イベントを確実に解除してメモリリークや多重登録を防ぐ!
};
});
補足:公式ドキュメント
まとめ
今回はGSAPでレスポンシブや環境に応じたアニメーション制御を行う gsap.matchMedia() について解説しました。
- 画面幅が切り替わると、古いアニメーションやScrollTriggerを自動で破棄・初期化(
revert)してくれる context.conditionsを使えば、PC/SPの分岐だけでなくprefers-reduced-motion(アクセシビリティ対応)なども一括管理できる- 独自のイベントリスナーなどを解除したい時は、最後に
return () => {}(クリーンアップ関数)を返す
gsap.matchMedia() を使いこなせば、どんな画面サイズやデバイス環境でも崩れない、保守性の高いアニメーションが実装できるようになります。ぜひご自身のWeb制作で活用してみてくださいね!