【GSAP】タイムライン(gsap.timeline)を自在に操る!再生・一時停止・逆再生・進捗制御デモ

Webサイトに滑らかで複雑なアニメーションを実装できるJavaScriptライブラリ「GSAP」。 なかでも複数のアニメーションを順番に繋げて管理できる gsap.timeline() は非常に強力ですが、その真価は「作ったアニメーションを後から自由自在にコントロールできる点」にあります。

ボタンクリックでアニメーションを再生・一時停止させたり、逆再生させたり、さらには動画プレイヤーのようにスライダー(シークバー)で進捗位置(プログレス)を直接操作することもたった1行のメソッドで可能です!

今回は、タイムラインを操作するための必須メソッド一覧と、それぞれの動きをリアルタイムに体験できるコントローラー付きデモをご紹介します!

デモ動作

See the Pen GSAPのタイムライン(timeline)制御まとめ! by mikanbako (@mikanbako) on CodePen.

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

実装コード紹介

【HTML】

<div class="l-wrap">
  <h2>GSAP Timeline コントローラーデモ</h2>
  <p class="p-desc">ボタンやスライダーを操作して、タイムラインの再生・停止・逆再生・速度変更を試してみよう!</p>
  
  <div class="p-demo-box">
    
    <!-- アニメーションのステージ -->
    <div class="c-stage">
      <div class="c-box js-box">BOX</div>
    </div>

    <!-- 進捗(プログレス)スライダー -->
    <div class="p-progress-wrap">
      <label class="c-progress-label">
        <span>再生位置 (progress): <strong class="js-progress-val">0.00</strong></span>
        <input type="range" class="js-progress-slider" min="0" max="1" step="0.01" value="0">
      </label>
    </div>

    <!-- 基本コントロールボタン群 -->
    <div class="c-control-group">
      <p class="c-group-title">🎮 基本の再生・停止・リセット操作</p>
      <div class="c-btn-wrap">
        <button class="c-btn c-btn--main js-restart">🔄 最初から再生 (restart)</button>
        <button class="c-btn js-pause">⏸ ストップ (pause)</button>
        <button class="c-btn js-play">▶ 途中から再生 (play)</button>
        <button class="c-btn js-reverse">◀ 逆再生 (reverse)</button>
        <button class="c-btn c-btn--sub js-reset">⏹ 初期状態に戻す (pause(0))</button>
      </div>
    </div>

    <!-- 応用コントロール(再生速度) -->
    <div class="c-control-group">
      <p class="c-group-title">⚡ 応用:再生速度の変更 (timeScale)</p>
      <div class="c-btn-wrap">
        <button class="c-btn c-btn--speed js-speed" data-speed="0.5">🐢 0.5倍速</button>
        <button class="c-btn c-btn--speed is-active js-speed" data-speed="1">1倍速 (標準)</button>
        <button class="c-btn c-btn--speed js-speed" data-speed="2">🐇 2倍速</button>
      </div>
    </div>

  </div>
</div>

【CSS】

/* ベース装飾 */
.l-wrap {
  padding: 40px 20px;
  width: 650px;
  margin: 0 auto;
  color: #3e3e3e;
  text-align: center;
}

h2 {
  margin-bottom: 10px;
  font-size: 16px;
  color: #1bb4d4;
}

.p-desc {
  margin-bottom: 25px;
  font-size: 16px;
  font-weight: bold;
  color: #666;
  line-height: 1.6;
}

.p-demo-box {
  padding: 30px;
  text-align: left;
  background: #fff;
  border-radius: 12px;
  box-shadow: 0 4px 15px rgb(0 0 0 / 5%);
}

/* ステージとボックス */
.c-stage {
  display: flex;
  align-items: center;
  height: 150px;
  padding: 0 30px;
  margin-bottom: 20px;
  overflow: hidden;
  background: #f0f4f8;
  border: 2px dashed #cbd5e1;
  border-radius: 8px;
}

.c-box {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 75px;
  height: 75px;
  font-size: 14px;
  font-weight: bold;
  color: #fff;
  background: #1bb4d4;
  border-radius: 12px;
  box-shadow: 0 4px 10px rgb(0 0 0 / 15%);
}

/* プログレススライダー */
.p-progress-wrap {
  padding: 15px 20px;
  margin-bottom: 25px;
  background: #f8f9fa;
  border: 1px solid #e9ecef;
  border-radius: 8px;
}

.c-progress-label {
  display: flex;
  flex-direction: column;
  gap: 16px;
  font-size: 14px;
  font-weight: bold;
}

.c-progress-label strong {
  font-family: monospace;
  font-size: 17px;
  color: #e83e8c;
}

input[type="range"] {
  width: 100%;
  cursor: pointer;
}

input[type="range"]::-webkit-slider-runnable-track {
  background: #ddd;
  height: 6px;
  border-radius: 6px;
}

input[type="range"]::-webkit-slider-thumb {
  -webkit-appearance: none;
  appearance: none;
  width: 16px;
  height: 16px;
  margin-top: -5px;
  background-color: #1bb4d4;
  border-radius: 50%;
}

/* ボタングループ */
.c-control-group {
  padding-top: 20px;
  margin-bottom: 20px;
  border-top: 1px solid #eee;
}

.c-control-group:last-child {
  margin-bottom: 0;
}

.c-group-title {
  margin-bottom: 12px;
  font-size: 16px;
  font-weight: bold;
  color: #1bb4d4;
}

.c-btn-wrap {
  display: flex;
  flex-wrap: wrap;
  gap: 10px;
}

.c-btn {
  padding: 10px 14px;
  font-size: 14px;
  font-weight: bold;
  color: #fff;
  cursor: pointer;
  background: #333;
  border-radius: 6px;
  transition: 0.2s;
}

.c-btn:hover {
  opacity: 0.85;
  transform: translateY(-2px);
}

.c-btn--main {
  background: #e83e8c;
}

.c-btn--sub {
  background: #6c757d;
}

.c-btn--speed {
  color: #333;
  background: #e9ecef;
}

.c-btn--speed.is-active {
  color: #fff;
  background: #1bb4d4;
}

【JavaScript】

// DOM要素の取得
const slider = document.querySelector('.js-progress-slider');
const progressVal = document.querySelector('.js-progress-val');
const speedButtons = document.querySelectorAll('.js-speed');

// 💡 1. GSAPタイムラインの作成
// paused: true を指定しておくことで、ページ読み込み時は自動再生せず待機させます
const tl = gsap.timeline({
  paused: true,
  // アニメーション進行中に毎回呼ばれるコールバック(スライダーの表示を連動させる!)
  onUpdate: () => {
    const currentProgress = tl.progress(); // 0 〜 1 の進捗率を取得
    slider.value = currentProgress;
    progressVal.textContent = currentProgress.toFixed(2);
  }
});

// タイムラインにアニメーションを登録(右へ移動&回転 ➔ 色変化&拡大 ➔ 縮小)
tl.to('.js-box', { 
  x: 220, 
  rotation: 180, 
  duration: 1, 
  ease: 'power1.inOut'
}).to('.js-box', { 
  x: 420, 
  rotation: 360,
  scale: 1.3, 
  backgroundColor: '#e83e8c', 
  borderRadius: '50%', 
  duration: 1, 
  ease: 'power1.inOut' 
}).to('.js-box', { 
  scale: 1, 
  borderRadius: '12px', 
  duration: 0.5, 
  ease: 'bounce.out'
});


// 💡 2. 各コントロールボタンのイベント設定

// ① 最初から再生(初期状態からスタート)
document.querySelector('.js-restart').addEventListener('click', () => {
  tl.restart();
});

// ② ストップ(現在の位置で一時停止)
document.querySelector('.js-pause').addEventListener('click', () => {
  tl.pause();
});

// ③ 途中から再生(止まっている位置から順方向へ再生)
document.querySelector('.js-play').addEventListener('click', () => {
  // ※もし最後まで再生し終わっている(progressが1の)状態で押されたら最初から再生する
  if (tl.progress() === 1) {
    tl.restart();
  } else {
    tl.play();
  }
});

// ④ 逆再生(現在の位置、または最後から最初に向かって再生)
document.querySelector('.js-reverse').addEventListener('click', () => {
  // ※もし初期状態(progressが0)で押されたら、最後から逆再生させる
  if (tl.progress() === 0) {
    tl.reverse(0); // 引数に0を渡すと「タイムラインの末尾」から逆再生します
  } else {
    tl.reverse();
  }
});

// ⑤ リセット(初期状態の0秒地点に戻してピタッと止める)
document.querySelector('.js-reset').addEventListener('click', () => {
  tl.pause(0);
  // スライダーの表示も0に更新
  slider.value = 0;
  progressVal.textContent = '0.00';
});


// 💡 3. スライダー操作による再生位置(progress)の直接指定
slider.addEventListener('input', (e) => {
  const val = parseFloat(e.target.value);
  // スライダーを動かしている間は一時停止し、指定した進捗位置(0〜1)へジャンプ!
  tl.pause().progress(val);
  progressVal.textContent = val.toFixed(2);
});


// 💡 4. 応用:再生速度(timeScale)の変更
speedButtons.forEach(btn => {
  btn.addEventListener('click', () => {
    speedButtons.forEach(b => b.classList.remove('is-active'));
    btn.classList.add('is-active');

    const speed = parseFloat(btn.dataset.speed);
    tl.timeScale(speed); // 0.5なら半分の速度、2なら2倍速になる!
  });
});

各操作メソッドの解説と使い分け

const tl = gsap.timeline(); として作成したタイムライン変数に対して、以下のメソッドを呼び出すだけで操作できます。

tl.play()(再生/途中から再生)

アニメーションを順方向に再生します。
pause() で途中で止めていた場合は「止めた位置から続きを再生」します。(※すでに最後まで完了している状態で play() を呼んでも何も起きないため、最初からやり直したい場合は次の restart() を使います!)

tl.restart()(最初から再生)

現在の位置に関わらず、強制的に「一番最初(0秒地点)に巻き戻して再生」をスタートします。

tl.pause()(一時停止/リセットにも使える!)

アニメーションをその場で止めます。
引数に秒数を渡して tl.pause(0) と書くと、「0秒地点(初期状態)に移動して一時停止する=リセット」という動きが1行で作れるため、非常によく使われます!

tl.reverse()(逆再生)

現在の位置から、最初(0秒地点)に向かって逆再生します。
モーダルウィンドウやドロワーメニューを「開く時は play()、閉じる時は reverse()」と使い分けると、閉じる用のアニメーションを別で作る必要がなくなるためとても便利です!
また、tl.reverse(0)のように引数に0を渡すと「タイムラインの末尾」から逆再生させることができます!

tl.progress()(進捗率の取得・設定)

タイムライン全体の長さを 0(開始前)〜 1(完了) の割合で扱います。 引数なしで tl.progress() と呼べば現在の進捗率を取得でき、tl.progress(0.5) のように数値を渡せば「全体の真ん中(50%)の時点」へ瞬時に状態をジャンプさせることができます。スライダー(シークバー)やスクロール連動を作る際の要となるメソッドです!

tl.timeScale()(再生速度の変更)

アニメーション全体のスピード倍率を変更します。
tl.timeScale(2) で2倍速、tl.timeScale(0.5) で0.5倍速(スロー再生)になります。長いアニメーションのデバッグ確認を素早く行いたい時などにも活躍します。

補足:tl.resume() や tl.seek() について

他にも、順再生・逆再生の「現在の向き」を維持したまま再開する tl.resume() や、進捗率(0〜1)ではなく「秒数」で位置を指定する tl.seek(1.5)(1.5秒地点へ移動)などのメソッドも用意されています。

補足:公式ドキュメント

・GSAP: play()
・GSAP: restart()
・GSAP: pause()
・GSAP: reverse()
・GSAP: progress()
・GSAP: resume()
・GSAP: seek()

まとめ

今回はGSAPのタイムライン gsap.timeline() を自在にコントロールするメソッドについて解説しました。

  • 続きから再生するなら play()、最初から再生し直すなら restart()
  • 途中で止めるなら pause()、初期状態にリセットするなら pause(0)
  • メニューの開閉などに活躍する逆再生は reverse()
  • 全体の進捗位置(0〜1)を取得・指定するなら progress()

CSSアニメーションだけでは難しい「途中からの再生・逆再生」や「シークバーによる進捗コントロール」も、GSAPのタイムラインを使えばお手軽に実装できます。ぜひUI制作に取り入れて、インタラクティブな動きを作ってみてくださいね!

Prev
Next