Communitygithub.com

FrontLaxWeb: parallaxとインタラクティブスクロール(プレミアム)

React (Motion + Lenis) と純粋な HTML/CSS/JS (GSAP + Lenis) の両方で、パララックス、インタラクティブスクロール、マイクロインタラクション、プレミアムジェスチャーをランディングページやウェブサイトにデザインします。ヒーローセクションの作成や改善、スクロール連動エフェクト、ビューポートイン時のリビール、スティッキー/スタッキングカード、スムーススクロール、3D チルト、スプリングを使ったドラッグ&ドロップ、中断可能なメニューやモーダル、またはユーザーがスクロール、マウス、指で操作する「インタラクティブビデオ」のように感じさせるあらゆるウェブサイトに使用してください。常に高速 (60fps) で、GPU がない場合でも動作し(標準でライトモード)、社内ポリシーに従い、アニメーションはすべての訪問者に表示され、オフにする代わりに動きの振幅を調整します(`--motion-gain` ダイヤル、`?motion=off` バルブ)。

FrontLaxWeb: parallaxとインタラクティブスクロール(プレミアム) とは?

このスキルは、ランディングページやウェブサイトにプレミアムなスクロール体験とインタラクションを実装するための包括的なガイドです。React(Motion + Lenis)とバニラ HTML/CSS/JS(GSAP + Lenis)の両方をサポートし、パララックス、スクロール連動アニメーション、ビューポートイン時のリビール、スティッキー/ピン効果、3D チルト、スプリングベースのジェスチャー(ドラッグ&ドロップ、スワイプ可能なカード、モーダル)など、7つの主要なエフェクトをカバーしています。 スキルの核心は、Apple のデザイン原則(中断可能性、速度の継承、ラバーバンディングなど)から着想を得たスプリングとジェスチャーの物理法則にあります。重要なのは、すべてのアニメーションが中断可能で、ユーザーの操作に自然に追従する必要があることです。 このスキルの特徴は、強制力のある独自のモーションポリシーにあります。`--motion-gain` CSS 変数を使用して、動きの振幅を調整します。デフォルトでは完全なエクスペリエンスを提供し、`prefers-reduced-motion: reduce` が設定されているシステムでは振幅を 25% に縮小し、`?motion=off` パラメータで完全に無効にすることもできます。これにより、動きを完全にオフにするのではなく適応させることで、アクセシビリティの準拠(WCAG 2.2.2 および 2.3.3)を維持しながら、すべての訪問者にアニメーションを表示するというポリシーを実現しています。 さらに、GPU がない環境向けの標準ライトモードが含まれており、Lenis のスムーススクロールを無効にし、`backdrop-filter` や `mix-blend-mode` などの負荷の高い CSS プロパティを代替し、WebGL コンテキストを安全に要求することで、統合グラフィックスを搭載していないマシンでもパフォーマンスを確保します。パフォーマンスルールでは、`getAnimations()` の使用を避け、GPU アクセラレーションに `transform` と `opacity` のみを使用することに重点を置いています。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Mun1to/FrontLaxWeb/tree/main

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

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

ドキュメント

FrontLaxWeb: parallaxとインタラクティブスクロール(プレミアム) は何をしますか?

このファイルは「頭脳」、つまり方法論です。レシピとスニペットは plantillas/ にあり、必要に応じて読み込まれます。plantillas/、references/、Designs/、Components/ のパスは、このファイルのフォルダを基準とします。

このスキルで実現できること

普通のランディングページをウェブ体験に変えます。スクロールとポインターが連続アニメーションのコントローラーになります。フレームワークに依存しません。各プロジェクトのカラー/トークンを受け取ります。

7つのエフェクト(カタログ)

  1. スムーススクロール(基盤): Lenis。すべてがプレミアムに感じられるようにするベース。
  2. レイヤーパララックス: 背景が遅く / 前景が速い = 奥行き。
  3. スクロール連動アニメーション: スクロールの%に応じて変化するプロパティ。
  4. スクロールリビール: ビューポートに表示されたときに出現/アニメーション。
  5. スティッキー / ピン: ある要素が「固定」され、周囲の要素が変化する(スタッキングカード)。
  6. ポインターのマイクロインタラクション: 3D チルト、カスタムカーソル、ホバー。
  7. スプリングを使ったジェスチャー: ドラッグ、ドロップ、タップ:固定長の CSS トランジションではなく、中断可能なスプリング物理。以下に専用セクションあり。

ジェスチャーとスプリング(Emil Kowalski のスキル apple-design から統合、WWDC のエッセンス)

上記のスクロール/パララックスとは異なる領域です。何かに触れてドラッグする(メニュー、スワイプ可能なカード、モーダル、スライダー)物理です。Web に最も実用的な原則(元の17の原則から;要約は references/recetas-y-matriz.md §4bis にあります):

  • 中断可能性(17の原則の中で最も重要): どのアニメーションも、遷移の途中で掴んで方向転換できる必要があります。ユーザーが触れる可能性のあるものにはスプリング(パラメータ:damping + response/速度)を使用し、固定長の CSS transition は絶対に使用しないでください。スプリングは常に現在の位置からアニメーションできますが、固定長のトランジションはできません。
  • 速度の継承: ジェスチャーを離したとき、アニメーションは指の速度で続きます(ゼロから始まらない)。これにより、視覚的な「継ぎ目」がなくなります。Motion の場合:dragMomentum + PanInfo の速度をスプリングの初速度として使用します。
  • ラバーバンディング: 限界では、抵抗が徐々に強くなり、決して硬いストップはありません。
  • 空間的一貫性: 右から入ってくるパネルは右に出ていく。transform-origin を遷移をトリガーした要素に固定します。
  • マテリアルと奥行き: 浮かぶ半透明レイヤー(backdrop-filter: blur())で視覚的な階層を作ります。2つの半透明サーフェスを直接重ねないでください。GPU がない場合、ライトモードはぼかしを削除します。半透明の背景は単体で読みやすくなければなりません。
  • クロスチェック(新しいレシピではありません):Apple の「フレームレベルのスムーズさ」のルールは、私たちがすでに譲れない基盤(transform/opacity のみ)で持っていたものと同じです。2つの独立した情報源が同じルールに到達することは、そのルールへの信頼性を高めます。
  • 背景の哲学(Apple の8つの基本原則): 目的、主体性、責任、親しみやすさ、柔軟性、シンプルさ、職人技、喜び(前述の7つを達成した結果)。これは実装するテクニックではなく、精神です。デザインの決定を正当化するために使用し(「これには目的があるか、それともノイズか?」)、技術的なチェックリストとして使用しないでください。

✅ 解決された緊張関係。 Apple の原則 #14(prefers-reduced-motion: reduce で、モーションを opacity フェードに置き換える)は、社内ポリシー(「すべての人にすべてを」、そのプリファレンスを無視する)と直接衝突していました。第三の道が勝利しました:モーションはオフにせず、振幅を下げます。 原則14は破棄もコピーもされていません。同じダイヤル(--motion-gain: 0 がフェードのみのウェブを生成)の極端なケースとして組み込まれているため、各エフェクトの2つのバージョンを維持する必要はありません。完全なメカニズムは「社内モーションポリシー」(以下の専用セクション)にあります。

譲れない基盤

  • パフォーマンス: transform と opacity(GPU)のみをアニメーション化します。top/left/width/height/margin は絶対に使用しないでください。will-change は適切に使用し、requestAnimationFrame を使用し、レイアウトスラッシングを避けてください。
  • GPU なし、ライトモード: すべてのウェブは、ソフトウェア描画の検出とそれに対応するライトモード(Lenis なし、ぼかしやブレンドなし、3D の場合は非 3D バージョン)と共に生まれます。以下の専用セクションを参照。
  • 社内モーションポリシー: すべてのプロジェクトで必須です。うっかり破られることの多いルールなので、すぐ下に専用セクションがあります。

社内モーションポリシー(必須)

すべての人に、適切な振幅で。 誰も動かないウェブを見ることはありません。訪問者によって変わるのは、動きの有無ではなく、その移動量です。ウェブ全体を制御する単一のダイヤル:<head> 内のスクリプトによって <html> に設定される CSS 変数 --motion-gain。

状況--motion-gain訪問者が見るもの
デフォルト1完全なエクスペリエンス。
システムが prefers-reduced-motion: reduce に設定0.25同じデザインが1/4の移動量で:動きはカメラワークではなくアクセントとして認識される。
URL に ?motion=off0自動で動いていたものはすべて静止し、motion クラスが削除される。ユーザーが指でドラッグするものは引き続き応答する:スワイプできないスワイプ可能なカードは、地味なインターフェースではなく、壊れた写真である。動きを望まない人のためのバルブであり、デザインモードではない。
URL に ?motion=full強制的に 1システムのプリファレンスを無視する。Windows のアニメーション効果が無効になっているマシンから作業を確認するため。

0.25 は標準の値で、エフェクトの要求に応じてプロジェクトごとに調整可能ですが、決して 1 にしてはいけません:reduce で何も変わらない場合、ポリシーを適用していないことになります。

ダイヤルの3つのルール

  1. gain は移動量を乗算します:ピクセル、スケール、回転、スキュー。連続エフェクト(マーキー、ループ)では速度を乗算します。
  2. gain は決して opacity を乗算しません。フェードは誰も酔わせません。そのため、ダイヤルを下げてもエフェクトは壊れません:劣化します。gain: 0.25 のマトリョーシカは同じものを表示しますが、カメラのズームではなく連続フェードの形で表示されます。そして、まさにこの理由から、このポリシーは各エフェクトの2番目のバージョンを記述することを強制しません。それが原則14の問題でした。
  3. gain はユーザーが指示する動きをスケーリングしません:ドラッグ、ホバー、ポインターによるチルト、カーソル lerp、ジェスチャーのスプリング。自分で引き起こした動きで内耳が不満を言うことはありません。要求されていない動きのみをスケーリングします:パララックス、スクロールによるズーム、マトリョーシカ、シーケンスのスクラブ、水平スクロール、速度スキュー、マーキー。

そして常に、さらに 4. 可視のバルブ。 ?motion=off に加えて、インターフェース内で到達可能なコントロール(フッターで十分)。URL にしか存在しないバルブは、それを必要とする人が見つけられません。 5. キーボードフォーカスとアンカーはそのまま維持し、JS なしでもコンテンツが読めるようにする(プログレッシブエンハンスメント)。

アクセシビリティ、厳密に(WCAG、MDN、web.dev に対して検証済み、2026-08-19):

  • このポリシーを準拠させているのはダイヤルではなく、バルブです。WCAG 2.3.3(レベル AAA)では、動きを無効化できることを要求しており、単に減らすことだけではありません。?motion=off はそのメカニズムであり、そのため必須かつ発見可能です。実際にオフにせずに単に縮小するだけのダイヤルは、2.3.3 の要件を満たしません。
  • reduce 下での 0.25 は開始点であり、絶対値ではありません。動きで酔うのは、振幅の大きい動き(パララックス、ズーム、大面積の移動)であって、opacity や小さな移動ではありません。細かいルール:reduce 下では、その大きな動きは〜ゼロにするか、フェードに置き換える必要があり、「より小さいけれど存在する」ままにしてはいけません。16px のリビールでは 0.25 で十分ですが、300px のパララックスでは 0.25 でもまだ酔う可能性があり、さらに低くするか、直接 opacity に移行する必要があります。これは MDN と web.dev が支持していることと正確に一致します:「削除、削減、または置換」。
  • WCAG 2.2.2 「一時停止、停止、非表示」(レベル A、必須、AAA ではない): 5秒以上の自動ループアニメーション(マーキー、背景ビデオ、動くグラデーション)には、必ず一時停止または停止のコントロールが必要です。このダイヤルはそれを代替しません。無限マーキーを配置する場合は、別途一時停止ボタンを追加してください。

セントラルスイッチ(そのまま <head> にコピーし、アニメーション CSS より前に配置):

<script>
(function () {
  var h = document.documentElement;
  var q = new URLSearchParams(location.search).get('motion');
  var reduce = matchMedia('(prefers-reduced-motion: reduce)').matches;
  var gain = q === 'off' ? 0 : q === 'full' ? 1 : reduce ? 0.25 : 1;
  h.style.setProperty('--motion-gain', String(gain));
  h.classList.toggle('motion', gain > 0);   // 互換性のため:アニメーション状態は html.motion に依存
})();
</script>

CSS では calc() 内で使用し、JS では一度読み取って乗算します:

const GAIN = parseFloat(getComputedStyle(document.documentElement)
  .getPropertyValue('--motion-gain')) || 0;

GPU なし:ライトモード(すべての新しいウェブに標準装備)

ケース。 ハードウェアアクセラレーションがオフになっているコンピュータ(古いコンピュータや企業のコンピュータでよくある)では、アニメーションスクロール付きの3つのウェブサイトがカクつき、cloudflare.com はスムーズでした。CPU 6倍速、GPU なし、1920x1080 で、画面に表示されるものを測定:

ウェブサイト改善前ライトモード適用後cloudflare.com (比較対象)
SaaS(Lenis、ガラス、3D)1.7 fps、2.4秒の停止27.5 fps、0.13秒の停止42.6 fps、47ms
ポートフォリオ(Lenis、ブラーオーブ、3D)4.6 fps、372ms24.8 fps、84ms45.3 fps、49ms
プロダクト(Lenisなし;ブラー付き雲、オーバーレイのグレイン、ガラスのデモ)30.1 fps、260ms42.6 fps、74ms46.5 fps、46ms

GPU がある場合、ライトモードは有効にならず、何も変わりません(3つすべてでピクセル単位で確認済み)。

理由。 GPU がない場合、プロセッサが GPU の役割を引き継ぎます:ぼかし、ブレンド、3D、各フレームの合成。そして Lenis では、スクロールは各フレームで私たちのコードによって移動されます。メインスレッドが 5 fps の場合、ページは 5 fps で移動します。ブラウザのスクロールは別のスレッドで移動されるため、メインスレッドがビジーでもスムーズです(そのため cloudflare.com は問題なく動作します:コードは 2 fps でも、画面は 86fps で更新されます)。

1. 検出(plantillas/react/dibujoPorSoftware.ts、または plantillas/vanilla/modo-ligero.js):getContext("webgl2"|"webgl", { failIfMajorPerformanceCaveat: true }) でコンテキストを要求します。null はソフトウェア描画を示します。コンテキストが取得できた場合は、すぐに解放します(WEBGL_lose_context)。訪問ごとに1回、最初のペイント後、LCP の前に実行します。?ligero=1 で強制し、?ligero=0 で解除します。同一オリジンの <iframe> 内では、外側の URL もチェックします。jsdom およびプリレンダリングでは、GPU があると見なします。

2. その場合のみ:

  • (a) Lenis を起動しない:ブラウザのスクロールを使用します。代わりに、同じ外観のネイティブピース(scrollTo を smooth で使用、メニュー用に <html> で overflow: hidden による stop/start、on("scroll")、animatedScroll)を使用します。これは plantillas/react/useLenis.ts(およびバニラでは arrancarScroll())のみが行います。アンカーとメニューには個別の if はありません。window.lenis に依存しません:Lenis 1.3 はすでにそこにデータを保存しています。
  • (b) <html data-ligero> と plantillas/vanilla/modo-ligero.css の CSS:backdrop-filter: none;filter: blur() のハローは、事前にぼかされた radial-gradient に変わります(scale プロパティで2倍のサイズに。パララックスの transform を上書きしません);mix-blend-mode(overlay のグレイン)は、透明度を下げた通常のブレンドに変わります。ほぼ同じに見え、同じように動きます。
  • (c) 3D:ウェブ上のすべての WebGL getContext は failIfMajorPerformanceCaveat: true を指定して要求され、GPU がない場合は自動的に非 3D バージョンにフォールバックします。この非 3D バージョンは存在する必要があります(画像、フラットなロゴ、または背景の装飾だった場合は何もなし)。
  • (d) アニメーションは変更しない。 社内ポリシーは変わりません:すべての人にアニメーションを。振幅を調整し、オフにはしません。そして測定済みです:表の SaaS では、アニメーション背景を削除したり CSS アニメーションを一時停止しても何も変わりませんでした(28 fps から 29-30 fps)。プロダクトでは、ドットやビームライトも同様です。負荷がかかるのは (a)、(b)、(c) です。

3. 測定し、推測しない(plantillas/medir-scroll-visible.mjs、playwright-core を使用してフォルダから実行):スクロール中に画面に表示されるフレーム数をカウントします(Chrome の画面出力を使用)。requestAnimationFrame はネイティブスクロール時に不正確なため、使用しません。常に cloudflare.com と一緒に同じセッションで2回測定します:SIN_GRAFICA=1 node medir-scroll-visible.mjs <url> 3 6(GPU なしのコンピュータ)および SIN_GRAFICA なしで CPU 4倍速(通常のノートパソコン)。Lighthouse のヘッドレス Chrome は GPU で描画するため、このテストには適しません。原因を特定するには、CSS を注入して(display: none、filter: none、mix-blend-mode: normal)一つずつ要素を削除し、再度測定します。これにより、表のプロダクトの雲(最初のフレームまで 0.8 秒から 0.35 秒に改善)、グレイン、デモが特定され、ヒーローイメージのガラス効果やドットはパフォーマンスに影響を与えないことがわかりました。

GPU 使用時のパフォーマンス:アニメーションスクロールのあるウェブ向け5つのルール

2つの実際のウェブサイトでの測定に基づきます(1つでは、CPU 4倍速で遅いフレームの処理時間が 580ms から 355ms に改善)。アニメーションを削除したり遅くしたりするのではなく、見えていない処理を削除します。

  1. animationend で getAnimations() を使用しない:ページ全体のスタイル再計算を強制します(4倍速で約 50ms、しばしばスクロールの途中で発生)。要素の animationstart と animationend をカウントします。
  2. スクロール中に transform/opacity のみを動かすアニメーションを一時停止しない:これらはコンポジタースレッドで実行され、一時停止しても何も節約できません。また、一時停止と再開はスクロールのたびに2回の大きな再計算を引き起こします。
  3. スクロール中に「空いた時間に」セクションをマウントしない:Lenis はフレーム間に空き時間を残し、requestIdleCallback はそのタイミングで実行されます。スクロールが停止するまで待ちます。
  4. 変更がない場合、スクロールの各フレームでスタイルを書き込まない(各カードに --bn: 0 を設定するなど)。

...

[以降の内容は翻訳の必要がある場合、続けて翻訳します]

関連スキル