【GSAP】スクロールを中途半端な位置で止めない!ScrollTriggerの snap 機能で指定位置に吸着するスクロール実装
GSAPのプラグイン「ScrollTrigger」を使ってスクロール連動アニメーションを実装する際、ユーザーがスクロールを途中で止めてしまい、「要素が半分だけ見えた中途半端な状態で止まってしまう」という悩みはよくありますよね。
そんな時に活躍するのが、指定した進捗位置(セクションの区切りなど)へ磁石のようにピタッと自動でスクロールを吸着させてくれる snap(スナップ)機能 です!
snap を使えば、等間隔での吸着はもちろん、吸い付くまでの待機時間(delay)や動きの加減速(ease)まで細かくカスタマイズできます。 今回は、実際にスクロールして吸い付く感覚を体験できるデモと一緒に、snap の基本的な指定方法から詳細設定までを分かりやすく解説します!
デモ動作
See the Pen GSAP ScrollTriggerの snap 機能を徹底解説! by mikanbako (@mikanbako) on CodePen.
demo: GSAP ScrollTriggerの snap 機能デモ
実装コード紹介
【HTML】
<div class="l-wrap">
<!-- 画面上部に固定するコントロール&進捗パネル -->
<div class="p-fixed-panel">
<div class="p-panel-inner">
<div class="c-status-row">
<span class="c-title">🧲 ScrollTrigger snap デモ</span>
<span class="c-progress">全体進捗 (progress): <strong class="js-progress">0.00</strong></span>
</div>
<!-- モード切り替えボタン -->
<div class="c-btn-group">
<button class="c-btn is-active js-mode-btn" data-mode="simple">① 基本:等間隔 (1 / 3)</button>
<button class="c-btn js-mode-btn" data-mode="custom">② 詳細設定:バウンド吸着</button>
<button class="c-btn js-mode-btn" data-mode="off">③ スナップ OFF</button>
</div>
</div>
</div>
<!-- スクロール対象の全4セクション -->
<main class="l-snap-container js-container">
<section class="c-section c-section--1">
<div class="c-card">
<span class="c-step">STEP 1 (進捗: 0%)</span>
<h2>下にスクロールして<br>途中で手を止めてみてね!</h2>
<p>一番近いセクションへピタッと自動で吸い付きます👇</p>
</div>
</section>
<section class="c-section c-section--2">
<div class="c-card">
<span class="c-step">STEP 2 (進捗: 33%)</span>
<h2>1 / 3 地点にスナップ!</h2>
<p>中途半端な位置で止まらず、綺麗に画面に収まります✨</p>
</div>
</section>
<section class="c-section c-section--3">
<div class="c-card">
<span class="c-step">STEP 3 (進捗: 67%)</span>
<h2>2 / 3 地点にスナップ!</h2>
<p>上のボタンで「バウンド吸着」に切り替えるとsnapの動きが変わるよ!</p>
</div>
</section>
<section class="c-section c-section--4">
<div class="c-card">
<span class="c-step">STEP 4 (進捗: 100%)</span>
<h2>ゴール地点(100%)🎉</h2>
<p>上に戻る時も同じようにピタッとスナップします!</p>
</div>
</section>
</main>
</div>
【CSS】
/* ベース装飾 */
.l-wrap {
color: #3e3e3e;
}
/* 上部固定コントロールパネル */
.p-fixed-panel {
position: fixed;
top: 15px;
left: 50%;
z-index: 100;
width: 90%;
max-width: 600px;
padding: 15px 20px;
background: rgb(255 255 255 / 95%);
border-radius: 12px;
box-shadow: 0 8px 25px rgb(0 0 0 / 12%);
transform: translateX(-50%);
}
.c-status-row {
display: flex;
align-items: center;
justify-content: space-between;
margin-bottom: 15px;
font-size: 14px;
font-weight: bold;
}
.c-title {
font-size: 16px;
color: #1bb4d4;
}
.c-progress strong {
font-family: monospace;
font-size: 18px;
color: #e83e8c;
}
/* モード切り替えボタン */
.c-btn-group {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: 10px;
}
.c-btn {
padding: 8px 6px;
font-size: 13px;
font-weight: bold;
color: #555;
cursor: pointer;
background: #f1f3f5;
border: 2px solid #dee2e6;
border-radius: 6px;
transition: 0.2s;
}
.c-btn:hover {
background: #e9ecef;
}
.c-btn.is-active {
color: #fff;
background: #1bb4d4;
border-color: #1bb4d4;
}
/* 各セクション(画面の高さ 100vh ずつ) */
.c-section {
display: flex;
align-items: center;
justify-content: center;
height: 100vh;
padding: 20px;
}
.c-section--1 {
background: #e0f7fa;
}
.c-section--2 {
background: #fff3cd;
}
.c-section--3 {
background: #ffe4e1;
}
.c-section--4 {
background: #d4edda;
}
/* 中央のカード */
.c-card {
display: flex;
flex-direction: column;
align-items: center;
gap: 15px;
width: 100%;
max-width: 500px;
padding: 40px 30px;
text-align: center;
background: #fff;
border-radius: 16px;
box-shadow: 0 10px 30px rgb(0 0 0 / 8%);
}
.c-step {
display: inline-block;
width: fit-content;
padding: 5px 15px;
font-size: 13px;
font-weight: bold;
color: #fff;
background: #333;
border-radius: 20px;
}
.c-card h2 {
font-size: 22px;
line-height: 1.4;
color: #1bb4d4;
}
.c-card p {
font-size: 16px;
font-weight: bold;
color: #666;
line-height: 1.6;
}
【JavaScript】
gsap.registerPlugin(ScrollTrigger);
const sections = document.querySelectorAll('.c-section');
const progressEl = document.querySelector('.js-progress');
const modeButtons = document.querySelectorAll('.js-mode-btn');
// セクションが4つある場合、移動する「区間」は 4 - 1 = 3区間 になります
// そのため、1区間あたりの進捗割合は「1 / 3(約0.333)」となります!
const snapStep = 1 / (sections.length - 1);
let stInstance = null; // ScrollTriggerのインスタンス保持用
// 💡 モードに応じてScrollTriggerを作成・再設定する関数
const createSnapTrigger = (mode) => {
// すでに作成済みの場合は一度破棄してリセット
if (stInstance) stInstance.kill();
// モードごとの snap 設定値を準備
let snapConfig = false;
if (mode === 'simple') {
// パターン①:シンプルに分割割合(1/3)だけを数値で指定
snapConfig = snapStep;
} else if (mode === 'custom') {
// パターン②:オブジェクト形式で、吸着の秒数やイージングを細かく指定!
snapConfig = {
snapTo: snapStep, // 吸着する間隔(1/3ずつ)
duration: 0.8, // 吸着アニメーションにかける時間(秒)
delay: 0.1, // スクロール停止から吸着開始までの待ち時間(秒)
ease: 'back.out(1.7)' // 少し行き過ぎて戻るバウンド風のイージング!
};
} else {
// パターン③:スナップなし
snapConfig = false;
}
// ScrollTriggerの生成
stInstance = ScrollTrigger.create({
trigger: '.js-container',
start: 'top top',
end: 'bottom bottom',
snap: snapConfig, // 💡 ここに設定を渡すだけで吸着機能が有効になります!
onUpdate: (self) => {
// 現在の進捗率(0.00 〜 1.00)をリアルタイム表示
progressEl.textContent = self.progress.toFixed(2);
}
});
};
// ボタンクリックでモード切り替え
modeButtons.forEach(btn => {
btn.addEventListener('click', () => {
modeButtons.forEach(b => b.classList.remove('is-active'));
btn.classList.add('is-active');
createSnapTrigger(btn.dataset.mode);
});
});
// 初期起動(基本の等間隔スナップ)
createSnapTrigger('simple');
snapの基本設定とカスタマイズ方法
snap の仕組み:進捗率(0 〜 1)を基準に吸着する!
ScrollTriggerの snap は、トリガー全体の開始位置を 0、終了位置を 1 とした「進捗率(progress)」を基準にして、どの地点に吸着させるかを指定します。
指定方法には、用途に合わせて以下の4つのパターンがあります。
パターン①:数値(分割割合)で等間隔にスナップさせる
最もよく使われる基本の形です。例えば snap: 0.5 と指定すれば、0、0.5(50%)、1(100%)の地点に吸着します。
同じ高さのセクション(や横スクロールのパネル)が複数並んでいる場合は、1 / (要素の数 - 1) という計算式を使うのが鉄板テクニックです!
const panels = document.querySelectorAll('.panel');
ScrollTrigger.create({
trigger: '.container',
start: 'top top',
end: 'bottom bottom',
// 要素が4つなら「1 / 3」となり、0, 0.333, 0.666, 1 の4箇所に均等に吸着する!
snap: 1 / (panels.length - 1)
});
※なぜ - 1 をするかというと、要素が4つあるとき、1つ目は最初から表示されているため、スクロールして移動する「区間の数」は3つになるからです!
パターン②:配列で「特定の位置だけ」にスナップさせる
各セクションの高さが違う場合など、等間隔ではなく任意の進捗位置にだけ吸着させたい時は「配列」で指定します。
// 0%, 20%, 70%, 100% の地点にだけピタッと止める
snap: [0, 0.2, 0.7, 1]
パターン③:タイムラインの「ラベル」にスナップさせる
gsap.timeline() と組み合わせている場合、タイムライン上に追加したラベル(.addLabel())の位置に合わせて自動で吸着させる snap: "labels"(またはスクロール方向を優先する "labelsDirectional")が非常に便利です!
const tl = gsap.timeline({
scrollTrigger: {
trigger: '.stage',
pin: true,
scrub: 1,
snap: 'labels' // ラベルを打った地点に自動でピタッと止まる!
}
});
tl.addLabel('start')
.to('.box', { x: 300 })
.addLabel('middle') // ここに吸着!
.to('.box', { rotation: 360 })
.addLabel('end');
パターン④:オブジェクト形式で動きを細かくカスタマイズする
「吸い付くスピードをゆっくりにしたい」「少しバウンドするようなイージングをつけたい」という場合は、snap にオブジェクト {} を渡して詳細設定を行います。
ScrollTrigger.create({
trigger: '.container',
start: 'top top',
end: 'bottom bottom',
snap: {
snapTo: 1 / 3, // 吸着位置(数値、配列、"labels" などを指定)
duration: { min: 0.2, max: 0.6 }, // 吸着にかける秒数(固定数値もOK)
delay: 0.1, // スクロールが止まってから吸着し始めるまでの待機秒数
ease: 'power2.inOut', // 吸着アニメーションのイージング
directional: true // 少しのスクロールでも進行方向の次の地点へ進ませる(初期値: true)
}
});
duration
移動距離によって自然に見えるよう{ min: 0.2, max: 0.6 }のように最小・最大秒数で指定することも、シンプルに0.5のように単一の秒数で指定することも可能です。delay
ユーザーがまだスクロールを続けている最中に勝手に引っ張られるのを防ぐため、0.1〜0.2秒ほど待ってから吸着を開始させます。
補足:公式ドキュメント
まとめ
今回はGSAP ScrollTriggerの snap 機能について解説しました。
- 均等なセクションやパネルに吸着させるなら
snap: 1 / (要素数 - 1) - タイムラインの区切りに吸着させるなら
snap: "labels" - 吸着方法をカスタムするならオブジェクト形式(
snapTo,duration,ease)
スクロール連動アニメーションに snap を1行プラスするだけで、ユーザーが操作したときの心地よさや画面の見やすさがグッと向上します。ぜひ色々な設定を試して、サイト演出に取り入れてみてくださいね!