Communitygithub.com

映画のようなスクロール連動型Web体験

スティッキーなSVG/CSSビューポート、スプリング・ラープスクロール物理エンジン、リアクティブSVGフィルター、そして調整された6ステージレールを用いて、映画のようなストーリーテリングページ、インタラクティブな漫画・エディトリアルビジュアル、スクロール駆動のプロダクトショーケースや高コンバージョンのEコマースランディングページをデザイン・構築します。

映画のようなスクロール連動型Web体験 とは?

このスキルは、スクロールに完全に連動したシームレスなWeb体験を構築するための専門的なフレームワークです。単一の正規化されたスクロール座標(`position` 0〜1)に基づいて、カメラズーム、SVGモーフィング、パーティクル、風物理、ナラティブコピーなど、すべてのビジュアルレイヤーを同期させます。アーキテクチャの核は、長いスクロールトラック内にスタックされた4つのスティッキーレイヤー(#sky, #world, #rail, #texture)で構成され、#railは`translate3d`を使って連続的に移動し、各シーン遷移はスムーズステップ関数で補間されます。対応モードは「ストーリーテリング/漫画」と「プロダクトショーケース/Eコマース」の2つで、それぞれ専用のリファレンスとテンプレートが用意されています。このスキルの最大の強みは、依存関係ゼロで60fpsのパフォーマンスを実現し、スプリング・ラープ物理ループと6段階のアーク(チャプター)設計により、自然で没入感のあるスクロール体験を提供する点です。開発者は、SVGのレイヤー設計、CSSとSVG属性の競合回避、アスペクト比の固定、テキストの視認性確保といった具体的なピットフォール対策を学びながら、映画のようなプロダクトローンチやストーリーテリングサイトを短期間で構築できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TuanAnhPhan-pika/cinematic-scroll-skill/tree/main/cinematic-scroll-web

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

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

ドキュメント

映画のようなスクロール連動型Webスキル

依存関係ゼロ、60fpsの連続スクロールインタラクティブWeb体験を構築します。カメラズーム、SVGモーフィング、パーティクル散乱、風物理、そしてナラティブ/セールスコピーといったすべてのビジュアルレイヤーが、単一の正規化されたスクロール座標([0, 1] の範囲の position)を共有します。

アーキテクチャの概要

すべてのページは、高いスクロールトラック内に4つのスティッキーレイヤーが積み重なった構造を持ちます:

#track (高さ: 700vh、自然なスクロール距離を生成)
└── #viewport (position: sticky; top: 0; height: 100vh; overflow: hidden)
    ├── #sky / 環境背景レイヤー (色と雰囲気の補間)
    ├── #world (独立したステージ: ヒーロー中心要素、SVGフィルター、パーティクル、雰囲気)
    ├── #rail (position: absolute; N個の100vhチャプターが連続的に移動)
    └── #texture / HUD (#bar, #meter, #guide, Eコマース用スティッキーCTAバー)
  • クラスだけで離散的なスライドを切り替えないでください。 #rail を translate3d(0, ${-position * (N - 1) * innerHeight}px, 0) で駆動し、すべてのシーン遷移をスムーズステップ(smooth(a, b, position))で補間します。
  • #world と #rail は非ブロッキング(pointer-events: none)に保ち、明示的なインタラクティブ要素(#overlay button、バリエーションスウォッチ、購入/カートCTA)のみ pointer-events: auto とより高い z-index を設定します。

ビルドワークフロー

  1. ドメインモードを選択する:
  2. レイヤードヒーローSVGをデザインする:
    • ヒーロー中心要素(キャラクター、エンブレム、または製品ハードウェア)を、単一の正規化された viewBox 内に、名前付き <g> レイヤーを使って構築します。これにより、個々のサブパーツを個別に回転、爆発分離、ズーム、またはカラーワイの切り替えが可能になります。
  3. スプリング・ラープループ(requestAnimationFrame)を配線する:
    • target = clamp(-track.getBoundingClientRect().top / maxScroll, 0, 1) を計算します。
    • position += (target - position) * 0.115 でイージングし、平滑化された speed と制限付き impulse(wind)を導出します。これにより、高速スクロールが自然に布、髪の毛、パーティクル、SVGディスプレイスメントフィルターを駆動します。
  4. 6ステージアークを調整する:
    • 0.00 -> 1.00 を6つの等間隔の 100vh .chapter セクション(top: 0 から top: 500vh)にマッピングします。
    • プログレッシブズーム(scale)とレイヤークロスフェード(smooth(a, b, position))を、簡潔な .caption カードと上部の #bar + #meter HUDと組み合わせます。
  5. 出荷前に確認する:
    • ローカルHTTPで提供し、00%、25%、50%、75%、100% のスクロール位置をテストします。
    • インタラクティブなオーバーレイ(#enter)、バリエーションセレクター、スティッキーCTAがクリック可能(pointer-events: auto)であることを確認します。
    • コンソールエラーがゼロであること、明るいフォーカル要素上でのテキストコントラストが読みやすいこと、デスクトップ(1280x800)とモバイル(390x844)の両方のビューポートでフレーミングがクリーンであることを確認します。

重要なSVGおよびCSSの落とし穴

SVG主体のスクロールページを構築する際に、以下の一般的な失敗モードを避けてください:

  1. CSSの #id { opacity: 0 } が setAttribute('opacity', ...) をブロックする: CSSのIDセレクターは、SVGプレゼンテーション属性を上書きします。CSSで opacity: 0 を使用する代わりに、初期状態としてSVG属性 opacity="0" を使用し、setAttribute('opacity', ...) で更新するか、JSで el.style.opacity を更新します。
  2. SVGの transform 属性はCSSの transform-origin を無視する: transform-box: fill-box; transform-origin: ... はCSS el.style.transform にのみ適用されます。SVGの setAttribute('transform', ...) を使用する場合は、回転/スケールを中心 (cx, cy) で明示的にラップします: translate(cx cy) rotate(deg) scale(s) translate(-cx -cy)。
  3. 鋭い楔形の代わりにキュービックベジェ曲線 (C) を使用する: 有機的な髪の毛、リボン、布、煙、液体の軌跡には、三角形の L スパイクや大きなCSSの skewX 歪みを避けてください。キュービックベジェ制御点を、phase と制限付き wind に沿ったサイン波オフセットで滑らかにアニメーションさせます。
  4. ヒーローラッパーのアスペクト比を viewBox に固定する: ヒーローSVGコンテナに aspect-ratio: <W>/<H>; height: auto; を指定します(独立した vw と vh の寸法を混在させない)。これにより、transform-origin ズーム座標がすべての画面サイズでターゲットに固定されます。
  5. 画面中央の雰囲気シームを防ぐ: 画面中央のフォグ/ミスト <path> 形状を、平坦な水平線(L1440 490 ... Z)に沿って閉じ、可視のストロークを付けないでください。stroke: none を使用し、クラウドバンドをビューポートの下で滑らかに閉じるか、またはうねるような下部曲線で閉じます。
  6. 発光フォーカルエリア上のテキストコントラストを保護する: 大きな表示タイトルにはレイヤードダークドロップシャドウ(text-shadow)を、キャプションには暗い半透明カード(backdrop-filter: blur(4px))を適用し、明るい月、グロー、またはメタリックな製品ハイライトの上を通過してもコピーが読みやすいようにします。

リファレンスと例

  • 物理エンジンとSVGエンジン — スプリング・ラープ数学、smooth()、リアクティブSVGフィルター、同心回転、進行するベジェ波、パーティクル散乱の式。
  • Eコマース適応ガイド — 6チャプターアークを製品ローンチ、分解ビュー、カラーワイ切り替え、スペックコールアウト、スティッキー購入バーに適応させる方法。
  • スターターテンプレート — あらゆるテーマに対応可能な、クリーンな6ステージ連続スクロールスキャフォールド。
  • Eコマースプロダクトショーケース — このエンジンで構築された、フル動作する高級時計/ハードウェア製品ローンチデモ。

関連スキル