Communitygithub.com

スクロールモーション

GSAP、ScrollTrigger、Lenisを使って、Webサイトにスクロール駆動アニメーションやエントランスアニメーション(リビール、パララックス、ピン留めセクション、水平スクロール、線画、カウンター、プリローダー)を追加します。ユーザーが「プレミアム感」を求めたり、スムーススクロール、パララックス、テストリビール、ピン留めセクション、アニメーションプリローダーをリクエストしたとき、あるいはGSAP、ScrollTrigger、Lenis、Locomotive、AOSの名前を挙げたときに使用します。

スクロールモーション とは?

このスキルは、GSAP、ScrollTrigger、Lenisを活用して、Webサイトにプロフェッショナルで魅力的なスクロールアニメーションを実装するための包括的なガイドです。リビール、パララックス、ピン留めセクション、水平スクロール、線画、カウンター、プリローダーなど、多彩なエフェクトを目的別に提供し、単なる装飾ではなく、コンテンツの構造や意図を伝えるアニメーション設計を重視します。アクセシビリティにも配慮し、`prefers-reduced-motion` 設定を尊重するコードと、パフォーマンスを最大化するためのベストプラクティス(transform/opacityのみのアニメーション、適切なイージングと継続時間、`once: true` による再生制御など)が含まれています。また、モバイル環境でのピン留め無効化やスクロールの最適化、デバッグ手法、GSAPが不要なシンプルなケースでの代替案(IntersectionObserver + CSS transitions)もカバーしており、あらゆるレベルの開発者が現場で即座に活用できる実践的な内容です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/main/skills/scroll-motion

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

スクロールモーション は何をしますか?

モーションは構造を説明するものであるべきです:何が新しく、何が一緒に属し、次に何を見るべきか。これらを何も行わないアニメーションは単なる装飾であり、パフォーマンスを犠牲にします。そのため、以下の各エフェクトは目的に結びついています。

セットアップ

<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 の最後のセクションを参照してください。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

関連スキル