【GSAP】タイムライン(gsap.timeline)を自在に操る!再生・一時停止・逆再生・進捗制御デモ
Webサイトに滑らかで複雑なアニメーションを実装できるJavaScriptライブラリ「GSAP」。 なかでも複数のアニメーションを順番に繋げて管理できる gsap.timeline() は非常に強力ですが、その真価は「作ったアニメーションを後から自由自在にコントロールできる点」にあります。
ボタンクリックでアニメーションを再生・一時停止させたり、逆再生させたり、さらには動画プレイヤーのようにスライダー(シークバー)で進捗位置(プログレス)を直接操作することもたった1行のメソッドで可能です!
今回は、タイムラインを操作するための必須メソッド一覧と、それぞれの動きをリアルタイムに体験できるコントローラー付きデモをご紹介します!
デモ動作
See the Pen GSAPのタイムライン(timeline)制御まとめ! by mikanbako (@mikanbako) on CodePen.
demo: GSAPのタイムライン(timeline)制御まとめ!
実装コード紹介
【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のタイムライン gsap.timeline() を自在にコントロールするメソッドについて解説しました。
- 続きから再生するなら
play()、最初から再生し直すならrestart() - 途中で止めるなら
pause()、初期状態にリセットするならpause(0) - メニューの開閉などに活躍する逆再生は
reverse() - 全体の進捗位置(0〜1)を取得・指定するなら
progress()
CSSアニメーションだけでは難しい「途中からの再生・逆再生」や「シークバーによる進捗コントロール」も、GSAPのタイムラインを使えばお手軽に実装できます。ぜひUI制作に取り入れて、インタラクティブな動きを作ってみてくださいね!