【GSAP】スクロールを中途半端な位置で止めない!ScrollTriggerの snap 機能で指定位置に吸着するスクロール実装

GSAPのプラグイン「ScrollTrigger」を使ってスクロール連動アニメーションを実装する際、ユーザーがスクロールを途中で止めてしまい、「要素が半分だけ見えた中途半端な状態で止まってしまう」という悩みはよくありますよね。

そんな時に活躍するのが、指定した進捗位置(セクションの区切りなど)へ磁石のようにピタッと自動でスクロールを吸着させてくれる snap(スナップ)機能 です!

snap を使えば、等間隔での吸着はもちろん、吸い付くまでの待機時間(delay)や動きの加減速(ease)まで細かくカスタマイズできます。 今回は、実際にスクロールして吸い付く感覚を体験できるデモと一緒に、snap の基本的な指定方法から詳細設定までを分かりやすく解説します!

デモ動作

See the Pen GSAP ScrollTriggerの snap 機能を徹底解説! by mikanbako (@mikanbako) on CodePen.

全画面でのデモ動作は以下のリンクからご確認下さい!(別タブで開かれます)

実装コード紹介

【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

まとめ

今回はGSAP ScrollTriggerの snap 機能について解説しました。

  • 均等なセクションやパネルに吸着させるなら snap: 1 / (要素数 - 1)
  • タイムラインの区切りに吸着させるなら snap: "labels"
  • 吸着方法をカスタムするならオブジェクト形式(snapTo, duration, ease)

スクロール連動アニメーションに snap を1行プラスするだけで、ユーザーが操作したときの心地よさや画面の見やすさがグッと向上します。ぜひ色々な設定を試して、サイト演出に取り入れてみてくださいね!

Prev
Next