ランディングページ構築
承認されたコピー、ビジュアルディレクション、デザイントークンを基に、JavaScriptをオフにしても完全に機能する静的ページに変換します。完全に機能するとは、訪問者がすべてのセクションを読め、ヘッダーからすべてのセクションにアクセスでき、フォームを送信できることを意味します。アニメーションや3Dは後で landing-skills:landing-motion によって追加され、すでに動作するページの上に重ねられます。
このスキルを使用せずに作成された複数のテストビルドで2つのバグが発生しており、このスキルは両方を不可能にするように設計されています。
paddingショートハンドを持つコンテナクラスがセクションの垂直方向のパディングを上書きし、すべてのセクションが隣接して配置されました。修正は構造的です。セクションはブロック軸を、コンテナはインライン軸を担当し、どちらもショートハンドを使用しません(ステップ5)。- 死んだフォーム:
action="#"、onsubmit="return false"、または「ありがとう」と表示してデータを破棄するスクリプト。修正:実際のaction、実際のmethod、サーバーがバックアップする成功ページ、およびページがバックできない成功メッセージなし(ステップ8)。
入力
コードを書く前に、ユーザーのプロジェクトからこれらを読み取ります。
| ファイル | そこから取得するもの |
|---|---|
landing/brief.md | landing-skills:landing-page が書き込むフィールド。使用するもの:言語(lang 用);コンバージョンアクション(フィールドとエンドポイントを持つフォーム、または none yet、または外部URL);スタック(名前付き、または detect);ドメイン(本番ドメイン、または unknown);連絡先ルート(フッターと /form-error/ 用);利用可能なアセット |
landing/copy.md | ページ順の各セクションのH2;最後のH2 Placeholders はすべてのギャップをリスト |
landing/direction.md | ソースとライセンス付きの書体、各セクションのレイアウト行、アスペクト比付きの画像、サーフェス、最終H2 Motion and 3D intent |
landing/tokens.css | カスタムプロパティ:--color-*、--font-*、--text-*、--space-*、--radius-* |
入力が欠けている場合:
copy.mdがない場合:自分でマーケティングコピーを作成しないでください。ユーザーにテキストを依頼するか、landing-skills:landing-copyを提案してください。ユーザーからテキストを受け取った場合は、そのまま使用します。証拠をでっち上げないでください:推薦文、ロゴ、数値、評価は一切使用しません。欠落部分は[PLACEHOLDER: 必要なもの]になります。direction.mdまたはtokens.cssがない場合:最初にlanding-skills:landing-art-directionを提案してください。ユーザーがそれなしで進めたい場合は、自分でlanding/tokens.cssを5つのプレフィックスで作成し、ユーザーから与えられたブランド制約から値を導出し、これらのトークンは暫定的なものであることをユーザーに伝えてください。brief.mdがない場合:言語、コンバージョンアクション(フォームとその投稿先、または外部URL)、本番ドメイン、連絡先ルートを尋ねてください。unknownまたはnone yetと記載されたブリーフフィールドはエラーではなくギャップです:このスキルがそのルールに従って構築し(ドメインがない場合はURLタグなし、エンドポイントがない場合は/api/leadプレースホルダー、連絡先ルートがない場合はプレースホルダーの連絡先行)、引き継ぎでそれをリストします。プロジェクトファイルからスタックを検出します(「スタック検出」を参照)。可能な場合は尋ねる代わりに。
プロセス
1. スタックを検出する
「スタック検出」の表を使用します。ファイルを書き込む前に references/adapters.md の該当セクションを読んでください。他のリファレンスのプレーンレシピと異なる点のみをカバーしています。
2. インベントリを作成する
マークアップの前に、以下を書き留めてください。
copy.mdの各H2と、それがなる<section>、およびそのid。tokens.cssのすべてのトークン名。色、書体、スペーシング、半径にはこれらの名前のみを使用します。- ディレクションで要求される各画像、そのアスペクト比、およびファイルが存在するかどうか。
- ブリーフからのコンバージョンアクション:外部URL(リンク、フォームなし)、またはフィールドとエンドポイントを持つフォーム。エンドポイントが
none yetの場合、フォームは/api/leadに投稿し、そのギャップは引き継ぎに含まれます(ステップ11)。 - ドメイン(既知または
unknown)と連絡先ルート。これらはヘッド、フッター、および/form-error/に必要です。
3. ヘッドを記述する
タイトル、説明、カノニカル、Open Graphとソーシャルカード、ファビコンセット、theme-color、lang、構造化データ。テンプレートとルールは references/seo-meta.md にあります。タイトルと説明は copy.md から記述します。フレームワークのスタータータイトルなどのデフォルトタイトルは避けてください。
4. フォントを読み込む
ディレクションで指定されたWOFF2ファイルをセルフホストし、tokens.css のスタックと正確に一致するファミリー名で @font-face を宣言し、メトリックマッチングされたフォールバックを追加し、ファーストビューで使用される1つまたは2つのファイルのみをプリロードします。references/performance.md にレシピと、フォールバック値を計算するテスト済みスクリプトがあります。フォントを指定して読み込まないページ、または system-ui にフォールスルーするページは、マシンごとに異なるレンダリングになります。
5. レイアウトの骨格を構築する
ページの各バンドは、内部に1つの <div class="container"> を持つ <section class="section"> です。この2つは決して役割を共有しません。
/* セクションは垂直方向のリズムを、コンテナは幅とガターを担当 */
.section { padding-block: var(--space-section-open); }
.container {
inline-size: min(100% - 2 * var(--space-gutter), var(--space-content-max));
margin-inline: auto;
}
上記のトークン名は例です。自分の tokens.css の名前を使用してください。references/css.md には、レシピが想定するすべてのトークンロールと、ファイルに対応するトークンがない場合の対処法がリストされています。
コンテナはパディングを一切設定しないため、ルールの順序や詳細度でセクションのスペーシングが消去されることはありません。セクションまたはコンテナクラスで padding または margin のショートハンドを決して使用しないでください。ショートハンドは両方の軸を設定し、他のクラスが設定したものを黙って置き換えます。これがバグ1を排除するルールです。references/css.md には、このバージョンの隣に壊れたバージョンと、全幅およびヘアラインケースが示されています。
6. セクションを構築する
- セマンティック要素を使用:
header、nav、main、section、footer、ステップにはol、仕様にはdlまたはtable、キャプション付きメディアにはfigure。 - ヒーローに1つの
h1。各セクションはcopy.mdから取得したh2で始まります。レベルをスキップしないでください。 - 各セクションを
direction.mdの該当行に従ってレイアウトします。ディレクションが形状を開いたままにしている場合は、references/css.mdのレシピから選択します。ブロックの数と形状はコンテンツに従うため、3つの等しいカードは、コンテンツが3つの等しいものである場合にのみ表示されます。 - すべての色、フォント、サイズ、スペース、半径にトークンを使用します。ページCSSでトークンを再宣言しないでください。必要な値にトークンがない場合は、トークンから構成し(
calc()、color-mix())、引き継ぎにリストしてディレクションが追加できるようにします。 clamp()による流動的なサイズ、論理プロパティ、references/css.mdのフォールバック付きoklch()色、および独自の幅に応じて形状が変わるコンポーネントにはコンテナクエリを使用します。
7. メディアを配置する
実際の画像には width と height、内容を説明する alt テキスト、フォールバック付きの最新フォーマット、およびヒーロー画像のみに fetchpriority="high" を設定します(references/performance.md)。まだ存在しないアセットは、最終的なアスペクト比で可視のラベル付きプレースホルダーボックスになり、[PLACEHOLDER: photo, the workshop bench from above, 3:2] などのテキストを表示します。ボックスに role="img" を設定しないでください。存在しない写真をアナウンスすることになります。各プレースホルダーに、ディレクションがその画像に指定する比率、幅、背景を設定し、フレームが同一の破線ボックスの行ではなく計画されたレイアウトを示すようにします(references/css.md、メディアプレースホルダー)。偽の製品画面を描画して製品として提示しないでください。
8. コンバージョンアクションを構築する
ブリーフのコンバージョンアクションが、構築するものを決定します。
- 外部URL(チェックアウト、予約ページ、アプリストア):アクションはリンク、
<a class="button" href="https://...">で、ラベルはcopy.mdから取得します。フォーム、form.js、/thanks/や/form-error/ページはありません。このステップの残りはスキップします。ブリーフがクリックをカウントする必要があると述べている場合、landing-skills:landing-launchがビーコンを追加します。 - ユーザーがすでに持っているエンドポイントへのフォーム:フォームはそのURLに投稿し、
/api/leadプレースホルダーは使用しません。そのエンドポイントがリダイレクトする場合にのみ結果ページを構築します。それ以外の場合は、引き継ぎでエンドポイントが訪問者をどこに送るかを記述します。 - エンドポイントが
none yetのフォーム:フォームはプレースホルダー/api/leadに投稿します。これはlanding-skills:landing-launchがWorkerとして構築します。
フォームの場合、references/forms-a11y.md を読んでください。不可欠な部分:
<form action="..." method="post">。アクションはブリーフからのエンドポイント、またはaction="/api/lead"で、その隣にエンドポイントがまだ存在しないことを示すHTMLコメントを付け、引き継ぎにリストします。- すべてのフィールドには
name、可視の<label>、適切なtypeとautocomplete、および形式を説明する必要がある場合はaria-describedbyでリンクされたヒントがあります。 - JavaScriptなしでブラウザはフォームを投稿し、エンドポイントは今構築する2つの静的ページのいずれかに
303リダイレクトで応答します:/thanks/と/form-error/。landing-skills:landing-launchがTurnstileを追加すると、JavaScriptのない訪問者はトークンを持たず、常に/form-error/に到達するため、そのページはブリーフの連絡先ルートから取得した別の連絡手段を提供する必要があります。 - 常に
references/forms-a11y.mdからform.jsをプログレッシブエンハンスメントとして出荷します。フォームはそれなしでも動作しますが、このファイルはビルドの一部であり、landing-skills:landing-motionが設定する状態を拡張し、landing-skills:landing-launchがそれらをチェックするためです。成功は、応答が2xxであり、そのJSONボディがok: trueを示す場合にのみ表示されます。2xxだけでは何かが応答したことしか証明しません。fetchはリダイレクトを追跡し、着地したページを200として報告し、静的ホストは通常のHTMLページでPOSTに応答できます。どちらもテストで発生し、両方とも失敗です。失敗した場合、スクリプトはその旨を表示し、訪問者が入力した内容を保持します。サーバーが確認する前にフォームをリセットしたり、「ありがとう」を表示したりしないでください。
9. アクセシビリティの最低基準を満たす
スキップリンク、ランドマーク、実際のセクションIDを指すリンクを持つ nav、/ にリンクするロゴ、すべてのインタラクティブ要素に可視のフォーカススタイル、少なくとも44x44ピクセルのターゲット、およびページが実際にレンダリングするすべてのテキストと背景のペアのコントラストチェック:各サーフェス上の本文テキスト、キャプション、ヒント、プレースホルダーテキスト、アクセント上のテキスト。詳細と数値は references/forms-a11y.md にあります。電話でリンクを非表示にし、代替手段のないナビゲーションはこの基準を満たしません。代わりにリンクを折り返してください。
10. モーションを除外する
[reduced motion] では、動きが削減されるのであって、フィードバックが削減されるわけではありません。したがって、トランジションをゼロにするグローバルルールは記述しないでください。すべての要素を最終的な可視状態で構築してください。エントランスアニメーション、スクリプトを待つ opacity: 0、スクロールライブラリは使用しません。
ディレクションの Motion and 3D intent で指定された各モーメントについて、スタンドインを残してください:静止したポスター画像、またはラベル付きプレースホルダーを、モーメントの最終的なサイズとアスペクト比で配置し、landing-skills:landing-motion が実際のものをマウントしたときにレイアウトがずれないようにします。data-moment="<name>" でマークし、ディレクションがそのモーメントに与える短い名前を使用します。モーションはその属性でターゲットを見つけます。スタンドインはモーションなしで完全です:alt テキスト付きの実際の画像、またはそのモーメントが示す内容を説明するプレースホルダーテキスト。
<div class="hero__media" data-moment="exploded-view">
<img src="/img/exploded-poster.jpg" width="1600" height="1000" alt="デバイスのレイヤーが広がっている:ケース、基板、バッテリー、レンズ">
</div>
インテントが none の場合、data-moment 要素を追加しないでください。
11. チェックして引き継ぐ
「完了の定義」を実行します。その後、ユーザーに短いリストで伝えます。
- 何がどこに構築されたか(ファイル、出力フォルダ)、および
detectと指定されていた場合にブリーフのスタックフィールドに書き込まれた解決済みスタック、 - ページ上にまだ残っているすべての
[PLACEHOLDER: ...]と提供すべきすべてのアセット、 - 構築されたコンバージョンアクション:外部URLへのリンク、ユーザーのエンドポイントに投稿するフォーム、またはまだ存在しない
/api/leadに投稿するフォーム、 - フォームが送信する各フィールド、1行に1つ:その
name、タイプ(email、tel、text、textarea)、requiredかどうか、およびマークアップからのmaxlength。landing-skills:landing-launchはこのリストからWorkerの検証、長さ制限、ストレージ、リクエストサイズ制限を設定し、通知されなかったフィールドを拒否します、 - トークンが存在しなかったために構成された値、および
tokens.cssに欠けていたオプショントークンと、レシピが使用したフォールバック、 - ブリーフが
unknownの場合の本番ドメイン、およびそのために省略されたURLタグ(カノニカル、og:url、og:image、サイトマップ)、 - ブリーフが
unknownのままにした連絡先ルート。フッターと/form-error/がプレースホルダーとして表示します、 - サブセット化されていない各フォントファイルとそのバイトサイズ、
- 実行されなかった「完了の定義」の各チェックと、その理由とともに「未実行」とマーク、
Motion and 3D intentからの各モーメント:そのdata-moment名と、そのスタンドインが配置されている場所(セクションと要素)、またはインテントがnoneの場合は「なし」、- 次のスキル:ディレクションの
Motion and 3D intentがモーメントを指定する場合はlanding-skills:landing-motion、次にlanding-skills:landing-review、次にホスティングとフォームエンドポイント用のlanding-skills:landing-launch。
スタック検出
プロジェクトルートをこの順序でチェックし、最初に一致した時点で停止します。brief.md の Stack フィールドは、プロジェクトフォルダが空の場合に決定します。
スタックが解決されたら、それを書き戻します。ブリーフのスタックフィールドが detect と記述されている場合、その1語を解決されたスタック(例:Astro、または plain HTML and CSS)に置き換え、landing/brief.md の他の部分は変更しません。後のスキルはフィールドを読み取り、未解決の語に遭遇するべきではありません。ユーザーが指定したスタックはそのまま保持されます。landing/brief.md がない場合は、作成しないでください。
| プロジェクト内のシグナル | スタック | アダプターセクション |
|---|---|---|
astro.config.mjs(または .ts、.js)、または package.json の依存関係に astro | Astro | Astro |
| [以下、翻訳対象のため省略] |
