FrontLaxWeb: parallaxとインタラクティブスクロール(プレミアム) は何をしますか?
このファイルは「頭脳」、つまり方法論です。レシピとスニペットは
plantillas/にあり、必要に応じて読み込まれます。plantillas/、references/、Designs/、Components/のパスは、このファイルのフォルダを基準とします。
このスキルで実現できること
普通のランディングページをウェブ体験に変えます。スクロールとポインターが連続アニメーションのコントローラーになります。フレームワークに依存しません。各プロジェクトのカラー/トークンを受け取ります。
7つのエフェクト(カタログ)
- スムーススクロール(基盤): Lenis。すべてがプレミアムに感じられるようにするベース。
- レイヤーパララックス: 背景が遅く / 前景が速い = 奥行き。
- スクロール連動アニメーション: スクロールの%に応じて変化するプロパティ。
- スクロールリビール: ビューポートに表示されたときに出現/アニメーション。
- スティッキー / ピン: ある要素が「固定」され、周囲の要素が変化する(スタッキングカード)。
- ポインターのマイクロインタラクション: 3D チルト、カスタムカーソル、ホバー。
- スプリングを使ったジェスチャー: ドラッグ、ドロップ、タップ:固定長の CSS トランジションではなく、中断可能なスプリング物理。以下に専用セクションあり。
ジェスチャーとスプリング(Emil Kowalski のスキル apple-design から統合、WWDC のエッセンス)
上記のスクロール/パララックスとは異なる領域です。何かに触れてドラッグする(メニュー、スワイプ可能なカード、モーダル、スライダー)物理です。Web に最も実用的な原則(元の17の原則から;要約は references/recetas-y-matriz.md §4bis にあります):
- 中断可能性(17の原則の中で最も重要): どのアニメーションも、遷移の途中で掴んで方向転換できる必要があります。ユーザーが触れる可能性のあるものにはスプリング(パラメータ:
damping+response/速度)を使用し、固定長の CSStransitionは絶対に使用しないでください。スプリングは常に現在の位置からアニメーションできますが、固定長のトランジションはできません。 - 速度の継承: ジェスチャーを離したとき、アニメーションは指の速度で続きます(ゼロから始まらない)。これにより、視覚的な「継ぎ目」がなくなります。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=off | 0 | 自動で動いていたものはすべて静止し、motion クラスが削除される。ユーザーが指でドラッグするものは引き続き応答する:スワイプできないスワイプ可能なカードは、地味なインターフェースではなく、壊れた写真である。動きを望まない人のためのバルブであり、デザインモードではない。 |
URL に ?motion=full | 強制的に 1 | システムのプリファレンスを無視する。Windows のアニメーション効果が無効になっているマシンから作業を確認するため。 |
0.25 は標準の値で、エフェクトの要求に応じてプロジェクトごとに調整可能ですが、決して 1 にしてはいけません:reduce で何も変わらない場合、ポリシーを適用していないことになります。
ダイヤルの3つのルール
gainは移動量を乗算します:ピクセル、スケール、回転、スキュー。連続エフェクト(マーキー、ループ)では速度を乗算します。gainは決して opacity を乗算しません。フェードは誰も酔わせません。そのため、ダイヤルを下げてもエフェクトは壊れません:劣化します。gain: 0.25のマトリョーシカは同じものを表示しますが、カメラのズームではなく連続フェードの形で表示されます。そして、まさにこの理由から、このポリシーは各エフェクトの2番目のバージョンを記述することを強制しません。それが原則14の問題でした。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、372ms | 24.8 fps、84ms | 45.3 fps、49ms |
| プロダクト(Lenisなし;ブラー付き雲、オーバーレイのグレイン、ガラスのデモ) | 30.1 fps、260ms | 42.6 fps、74ms | 46.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 に改善)。アニメーションを削除したり遅くしたりするのではなく、見えていない処理を削除します。
animationendでgetAnimations()を使用しない:ページ全体のスタイル再計算を強制します(4倍速で約 50ms、しばしばスクロールの途中で発生)。要素のanimationstartとanimationendをカウントします。- スクロール中に
transform/opacityのみを動かすアニメーションを一時停止しない:これらはコンポジタースレッドで実行され、一時停止しても何も節約できません。また、一時停止と再開はスクロールのたびに2回の大きな再計算を引き起こします。 - スクロール中に「空いた時間に」セクションをマウントしない:Lenis はフレーム間に空き時間を残し、
requestIdleCallbackはそのタイミングで実行されます。スクロールが停止するまで待ちます。 - 変更がない場合、スクロールの各フレームでスタイルを書き込まない(各カードに
--bn: 0を設定するなど)。
...
[以降の内容は翻訳の必要がある場合、続けて翻訳します]