ランディングモーション
すでにモーションなしで動作するランディングページに、モーションと3Dを追加します。 追加するすべての効果には、明確な目的、動きを減らす設定用の代替、そしてページを完全な状態に保つフォールバックが必要です。作業を開始する前の静的なページがフォールバックです。スクリプトが失敗した場合、ブラウザが機能を欠いている場合、または訪問者が動きの低減を希望する場合、そのページが表示され、空白のページは表示されません。
入力
landing/direction.md、セクション「モーションと3Dの意図」。これが作業の概要です。noneと指定されているか、各瞬間とその目的が記載されています。指定されたものを実装してください。指定されていない瞬間は追加しないでください。landing-skills:landing-buildで構築された静的ページ、または既存の任意のページ。JavaScriptを無効にした状態で、すべてのコピーとコンバージョンアクションがレンダリングされる必要があります。まずこれを確認してください。そうでない場合は、モーションを追加する前に修正してください。ここでのすべてのレシピは、静的なページがフォールバックであることを前提としています。- 存在する場合は
landing/tokens.css。シェーダーやフォールバックでその色を使用します。モーショントークン(持続時間、イージング)は独自のスタイルシートに配置し、tokens.cssはアートディレクションが記述したままにしておきます。
入力が欠落している場合:
direction.mdがない場合:ユーザーに何を動かすべきか、その理由を尋ねてください。尋ねられない場合、デフォルトはnoneです(「何を動かすか決める」を参照)。その旨をサマリーに記載してください。- 静的ページがない場合:停止してまずビルドします(
landing-skills:landing-build)、またはそれを要求します。JavaScriptでしか存在しないページにモーションを重ねることは、3Dシーンが失敗した場合に見出しとコールトゥアクションもろともダウンさせる方法です。 - スタック:
package.jsonを読んでください。React(Vite、Next)の場合は、レシピにReact向けのバリアントがあればそれを使用し、それ以外の場合はプレーンなHTML、CSS、JavaScriptのバリアントを使用します。クライアント専用のReactアプリ(すべてが空の#rootにレンダリングされる)は、JavaScriptなしのチェックを構造的に失敗します。コピーは、サーバーレンダリング、プリレンダリング、またはreferences/webgl-3d.mdのアイランドパターンを介して、最初にHTMLに含まれている必要があります。
何を動かすか決める
direction.mdの意図から始めます。そこに指定されている各瞬間について、要素、役割(エントランス、フィードバック、スクロール連動、アンビエント、またはインタラクティブ3D)、そして訪問者がそこから学ぶことを書き留めます。その文を完成できない場合は、その瞬間を削除します。
noneは有効な答えであり、多くの場合正しい選択であり、意図がない場合のデフォルトです。多くのページは、特に写真やコピーがページを支えている場合、フィードバック状態以外のモーションがなくても完成しています。ほとんどモーションのないページは、それによって何も失いません。
noneの場合、これは新しい作業ではなく、簡単なチェックです。landing-skills:landing-buildはすでにホバー、フォーカス、プレス、無効状態、および送信、成功、エラー状態を持つフォームスクリプトを書き出しています。ブラウザでページを開き、以下の4つを確認します。
- タブ移動ですべてのリンク、ボタン、フィールドに可視のフォーカスリングが表示されること。
- ボタンとリンクでホバーとプレス状態が応答すること。
- フォーム送信後、ステータスメッセージが表示され、フォーカスが移動すること(
references/interaction.mdの「フォーム送信フィードバック」で不足している場合は追加)。 - 自動再生、ループ、表示といった、自分自身で動くものがないこと。
オプションでホバーとプレス状態にタイミングを追加できます(references/interaction.mdの「ホバーとプレス状態」)。その後、停止します。ブラウザを開けなかった場合はその旨を伝え、4つの各項目を「未実行」としてリストアップし、ページをチェック済みとして報告しないでください。
意図が瞬間を指定している場合:
- ページごとに1つの特徴的な瞬間。 ヒーローシーケンス、製品デモ、3Dオブジェクト。それ以外のものはそれよりも控えめにします。
- セクションではなく役割によって変化させる。 フィードバックは速く(100〜200ミリ秒)、エントランスはより遅く、スクロール連動モーションはスクロールに追従します。すべてのセクションに同じフェードアップ、イージング、スタッガーを適用することは、最も認識されやすい生成ページのパターンであり、訪問者に何も教えません。
- ほとんどのコンテンツは動かない。 訪問者が読んでいるテキストは決して動きません。段落にパララックスをかけたり、ブロックがスクロールされるまで隠すリビールは使用しません。
- 装飾ではなく実演する。 製品の仕組みを示すモーション(状態のシーケンス、展開ビュー、ビフォーアフター)はそのコストに見合います。「このページはアニメーションしています」と言うだけのモーションは価値がありません。
モーションを書き始める前にreferences/foundations.mdを読んでください。持続時間、イージング、そして生成されたと認識されるパターンのリストと、それぞれの代わりにすべきことが書かれています。
ページにレシピを適合させる
レシピは既存のページに付加され、ページのスタイルを変更しません。
landing-skills:landing-buildの静的ページは、directionが指定する各瞬間の代わりとなるものを残します。最終的なサイズのポスター画像またはラベル付きプレースホルダーです。その要素にdata-moment="<name>"(「モーションと3Dの意図」の名前)をマークします(ビルドがまだ行っていない場合)。そしてレシピをそれに付加します。レシピのコンテナクラスをその要素に追加するか、属性で選択します。- 各レシピのコードセクションは、このスキルで新しく追加するクラスと、ビルドのクラスを変更せずに使用することを示す行で始まります。新しいクラスを追加し、ビルド独自のクラス(
.hero、.hero__title、.button、.section、.splitなど)を再定義しないでください。レシピにビルドの要素が持っていないレイアウトが必要な場合は、独自の新しい要素でラップします。 - レシピに必要な色やサイズには、ビルドのトークン(
--color-*、--space-*、--radius-control)を使用し、新しいリテラル値は絶対に使用しないでください。
レシピの選択
効果を生み出す最も低い段階を選んでください。CSS、次に小さなスクリプト、次にGSAPまたはMotion、最後にWebGLです。各レシピには「いつ使うか」「避けるべき時」「コード」「動きを減らす設定」「コスト」があり、3Dレシピには「フォールバック」が追加されます。
| ニーズ | 読むべきもの |
|---|---|
| 持続時間、イージング、スプリング、スタッガー、生成されたと認識されるもの | references/foundations.md |
| ヒーローエントランス、分割テキスト見出し、クリップパスまたはマスクを使ったリビール、カウンター | references/entrances-text.md |
| スクロール進行、スクロール連動エントランス、スティッキーなストーリーテリング、固定または水平セクション、スムーススクロール | references/scroll.md |
| スクロールに応じた奥行きレイヤー、ポインター奥行き、画像またはビデオパララックス、Reactでのパララックス | references/parallax.md |
| ホバーとプレスのタイミング、フォーム送信フィードバック、マグネティックボタン、カーソルフォロワー、チルト、ドラッグ、ステップダイヤル、ビュートランジション | references/interaction.md |
| 回転する3Dオブジェクト、スクロールに応じた展開ビュー、離れた2つのステージを結ぶ1つのコンテキスト、glTFモデル、React Three Fiberアイランド | references/webgl-3d.md |
| インポートすべきものと除外すべきもの、ビルド内の未使用デコーダーファイル、ポスター作成、モデル圧縮とテクスチャ | references/webgl-assets.md |
| スクロール駆動カメラパス、シェーダーバックグラウンド、パーティクル、画像歪み、WebGPU | references/webgl-effects.md |
| どのライブラリか、そのライセンスとサイズ、CSSで十分な場合 | references/libraries.md |
| 動きを減らす設定用のバリアント、WebGLフォールバック、一時停止、予算、ヒーローの保護 | references/safety.md |
3DまたはWebGLの作業を行う場合は、最初にreferences/safety.md(シーンレシピはそのヘルパーをインポートします)を読み、次にreferences/webgl-3d.mdの「どのシーンよりも前に」を読み、その後必要なレシピだけを読んでください。
セーフティレール
これらはすべての効果に適用されます。references/safety.mdにコードがあります。
- ヒーローはJavaScriptなしで描画される。 見出し、リード、コールトゥアクションはHTMLにあり、最初の描画時に表示されます。見出しやヒーロー画像をopacity 0から開始しないでください。opacity 0の要素は表示されるまでLargest Contentful Paintの対象にならないため、エントランスが長いとLCPが遅れます。3Dコードはロードイベントの後に読み込み、最初のフレームが描画されるまでその場所にポスター画像を表示します。
- 削除ではなく低減する。 direction自身の動きの低減に関する記述が優先されます。以下はデフォルトです。
prefers-reduced-motion: reduceの下では、パララックス、スクラブスクロールアニメーション、自動再生ループ、大きな移動を削除します。フィードバックと短いフェードは維持します。3Dシーンは、静止してユーザー駆動の場合にのみ読み込まれます。スキップしてポスターを表示することが最もシンプルで正しい選択です。動きを低減するバリアントは効果ごとに記述し、ページが開いている間に設定が変更されるのをリッスンします。すべてのアニメーションの持続時間をゼロにするグローバルルールは、それ自体が認識されやすい兆候です。 - WebGLはオプション。 3Dコードをダウンロードする前にコンテキストを確認してください。Reactでは、キャンバスをエラーバウンダリでラップします。コンテキスト損失を処理します。フォールバックは実際の画像であり、空のボックスではありません。
- キャンバスは1つ。 2つ目のWebGLコンテキストはメモリとGPU負荷を倍増させます。関連する3D瞬間は1つのステイッキーキャンバスにまとめます。
- 画面外では何も実行しない。 キャンバス、ビデオ、ループはビューの外またはタブが非表示のときに停止します。
- スクロールでフレームワークを再レンダリングしない。 スクロール位置はフレームループで読み取るか、CSSに任せます。スクロールイベントやフレームごとに
setStateを使用しないでください。 transformとopacityのみをアニメーション化する。top、left、width、heightは絶対に使用しないでください。- すべてのアセットをセルフホストする。 モデル、デコーダー、環境マップ、フォントは自身のオリジンから提供します。一部のヘルパーはデフォルトでサードパーティのCDNを使用します。それらを上書きしてください。
- インタラクションにはキーボードパスがある。 ポインターが回転、ドラッグ、トグルできるものはすべて、キーボードでも操作できる必要があります。
完了条件
各項目をブラウザで確認します。ブラウザツールが最適です。ない場合は、landing-skills:landing-reviewのキャプチャスクリプトを使用してスクリーンショットを取得し、実行できなかったチェックを明記してください。
- 「モーションと3Dの意図」で指定されたすべての瞬間が存在し、フィードバック状態以外は何も追加されていない。
- JavaScriptを無効にした状態:すべてのコピーとコンバージョンアクションが存在する。
- 動きの低減をエミュレートした状態:ページが完全で読みやすく、自動再生、パララックス、スクラブがなく、フィードバック状態は応答する。
- WebGLを無効にした状態(Chromiumフラグ
--disable-webgl):シーンがあるべき場所にポスターまたは静止画像が表示され、ヒーローテキストとコールトゥアクションは変更されていない。 - ヒーローテキストは3Dコードが読み込まれる前に表示される(ネットワークをスロットルして確認)。
- デフォルトで2つのセクションが同じエントランスアニメーションを共有していない。特徴的な瞬間だけが唯一の大きなものである。
- キャンバスはビューの外にスクロールされると描画を停止する(パフォーマンスパネル、または
references/safety.mdの描画呼び出しカウンターで確認)。 - ネットワークパネルに3Dアセットのサードパーティホストへのリクエストが表示されない。
- プロダクションビルドでは、three.jsおよびその他の3Dコードはエントリーバンドルの一部ではないチャンクにある。
- キーボード:すべての回転、ドラッグ、トグルがキーで機能し、フォーカスが表示されたままになる。
兆候検出ツールdetect-tells.mjsはlanding-skills:landing-reviewに属し、オプションの補助です。利用可能な場合はページ上で実行します。これにより、典型的なリビール属性や動きの低減キルスイッチなどのパターンレベルの兆候がフラグされます。必要なチェックは目視です。モーションをオンにした状態と動きを低減した状態でページ全体を1回スクロールし、動くすべてのものがあなたが書き留めた役割を持っていることを確認します。
最後に、ユーザー向けの短いサマリーを記述します。追加された各瞬間とその目的、追加されたライブラリとそのライセンス、まだ必要なアセット(例えばプリミティブの代わりを置き換える実際のモデル、ポスター画像)、そして実行できなかったチェックです。