スクロールモーション は何をしますか?
モーションは構造を説明するものであるべきです:何が新しく、何が一緒に属し、次に何を見るべきか。これらを何も行わないアニメーションは単なる装飾であり、パフォーマンスを犠牲にします。そのため、以下の各エフェクトは目的に結びついています。
セットアップ
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/lenis@1/dist/lenis.min.js"></script>
<script defer src="/js/main.js"></script>
defer はスクリプトが最初の描画をブロックするのを防ぎつつ、順序通りに実行されるようにします。これにより、main.js(以下のコード)は gsap を認識できます。本番環境では、正確なバージョン([email protected])を指定するか、ファイルを自己ホスティングしてください。
gsap.registerPlugin(ScrollTrigger);
const reduce = matchMedia("(prefers-reduced-motion: reduce)").matches;
if (!reduce) {
const lenis = new Lenis({ duration: 1.1, smoothWheel: true });
lenis.on("scroll", ScrollTrigger.update);
gsap.ticker.add((t) => lenis.raf(t * 1000));
gsap.ticker.lagSmoothing(0);
}
すべてのアニメーションを if (!reduce) で囲むか、gsap.matchMedia() を使用してください。前庭障害を持つ人々はその設定を正当な理由で行っており、コンテンツはモーションなしでも完全に表示可能でなければなりません。
エフェクトの選択
| 目的 | エフェクト | 参照セクション |
|---|---|---|
| 新しいセクションを知らせる | マスク付き見出しリビール | リビール |
| アイテムが一緒に属していることを示す | スタガード・フェードアップ | リビール |
| 画像に奥行きを加える | パララックス、クリップパスリビール | 画像 |
| シーケンスを伝える | ピン留めステップ、線画 | ピン留め |
| 作品の範囲を示す | 水平スクロール | ピン留め |
| 数字を強調する | カウントアップ | 詳細 |
| 初期読み込みをカバーする | プリローダー | 詳細 |
各エフェクトのコピー可能なコードは references/snippets.md にあります。エフェクトを実装しようとするときにそれを読んでください;計画段階では必要ありません。
ハウスルール
transformとopacityのみをアニメーション化する。top、width、margin、box-shadowをアニメーション化すると、毎フレームレイアウトまたは描画がトリガーされ、ミッドレンジのスマートフォンでカクつきます。- 継続時間: リビールは 0.6 ~ 1.0 秒、ホバーは 0.2 ~ 0.3 秒。長すぎると2回目の訪問時に遅く感じます。
- イージング: エントランスには
power3.out、トランジションにはpower2.inOut、スクラブアニメーションにはnone(スクラブがイージングを提供します)。 - スタガー: 0.06 ~ 0.12 秒。合計を制限する:12枚のカードがある場合、最初の6枚をスタガーし、残りはまとめて表示します。
- 一度だけ再生する。
once: trueまたはtoggleActions: "play none none none"を使用してください。スクロールバックするたびに再アニメーションするのは疲れます。 - 1ページに1つの見せ場。 ピン留めセクションや水平スクロールは一度なら印象的ですが、3回もあると疲れます。
- 初期状態はCSSではなくJSで設定する。 スクリプトの読み込みに失敗した場合、CSSで非表示にしたコンテンツは永久に表示されません。
- レイアウト変更後にリフレッシュする: フォントや画像が読み込まれた後に
ScrollTrigger.refresh()を呼び出さないと、トリガー位置がずれます。
window.addEventListener("load", () => ScrollTrigger.refresh());
document.fonts?.ready.then(() => ScrollTrigger.refresh());
モバイル
gsap.matchMedia()を使用して、768px 未満ではピン留めと水平スクロールを無効にし、コンテンツを通常通りに積み重ねます。- タッチデバイスでのLenisのスムーススクロールは、ネイティブの慣性と衝突することがよくあります。特に依頼がない限り、タッチスクロールはネイティブのまま(デフォルト)にしてください。
- 小さな画面ではパララックスの距離を半分にします。
デバッグ
- ScrollTrigger に
markers: trueを追加すると、開始行と終了行が表示されます。 - ピン開始時のジャンプは、通常、ピン留めされた要素に transform を持つ親要素があるか、高さが変化していることが原因です。
- アニメーションが早すぎる:その上の画像の読み込みが遅れました。画像に明示的な
widthとheightを設定してください。 - 何もアニメーションしない:プラグインが登録されていること、セレクタが一致していることを確認してください。
GSAP を使わない場合
小規模サイトでのシンプルなフェードアップには、IntersectionObserver でクラスを追加し、CSS トランジションを組み合わせるだけで十分であり、約 70 KB 節約できます。references/snippets.md の最後のセクションを参照してください。