Construction d'une page d'atterrissage
Transformez la copie approuvée, la direction visuelle et les jetons de design en une page statique complète, même avec JavaScript désactivé. Complète signifie qu'un visiteur peut lire chaque section, accéder à chaque section depuis le header et envoyer le formulaire. Les animations et la 3D viennent plus tard, via landing-skills:landing-motion, et se superposent à une page qui fonctionne déjà.
Deux bugs sont apparus dans plus d'un test réalisé sans cette compétence, et cette compétence est conçue pour les rendre impossibles tous les deux :
- Une classe de conteneur avec une propriété raccourcie
paddinga remplacé le padding vertical de la section, de sorte que chaque section était collée à la suivante. La correction est structurelle : la section possède l'axe de bloc, le conteneur possède l'axe en ligne, et aucun des deux n'utilise la propriété raccourcie (étape 5). - Un formulaire mort :
action="#",onsubmit="return false", ou un script qui affichait "Merci" et jetait les données. La correction : uneactionréelle, unemethodréelle, une page de succès côté serveur, et aucun message de succès que la page ne peut pas confirmer (étape 8).
Entrées
Lisez ces éléments depuis le projet de l'utilisateur avant d'écrire du code.
| Fichier | Ce que vous en tirez |
|---|---|
landing/brief.md | les champs que landing-skills:landing-page écrit. Vous utilisez : Langue (pour lang) ; Action de conversion (soit un formulaire avec ses champs et son endpoint, soit none yet, soit une URL externe) ; Stack (tel que nommé, ou detect) ; Domaine (le domaine de production, ou unknown) ; Routes de contact (pour le footer et /form-error/) ; Ressources disponibles |
landing/copy.md | un H2 par section de page dans l'ordre de la page ; le dernier H2, Placeholders, liste chaque écart |
landing/direction.md | les polices avec source et licence, la ligne de mise en page pour chaque section, les images avec leurs proportions, les surfaces, et le dernier H2 Motion and 3D intent |
landing/tokens.css | les propriétés personnalisées : --color-*, --font-*, --text-*, --space-*, --radius-* |
Lorsqu'une entrée manque :
- Pas de
copy.md: n'écrivez pas de texte marketing vous-même. Demandez le texte à l'utilisateur ou suggérezlanding-skills:landing-copy. Si l'utilisateur vous donne du texte, utilisez-le tel quel. N'inventez jamais de preuves : pas de témoignages, logos, chiffres ou évaluations. Un élément manquant devient[PLACEHOLDER : ce qui est nécessaire]. - Pas de
direction.mdoutokens.css: suggérez d'abordlanding-skills:landing-art-direction. Si l'utilisateur souhaite continuer sans, écrivez vous-mêmelanding/tokens.cssavec les cinq préfixes, dérivez les valeurs des contraintes de marque données par l'utilisateur, et indiquez à l'utilisateur que ces jetons sont provisoires. - Pas de
brief.md: demandez la langue, l'action de conversion (un formulaire et où il doit poster, ou une URL externe), le domaine de production et une route de contact. - Un champ du brief qui dit
unknownounone yetest un écart, pas une erreur : construisez avec la règle que cette compétence lui donne (pas de balises URL sans domaine, le placeholder/api/leadsans endpoint, une ligne de contact placeholder sans routes de contact) et listez-le dans la remise. Détectez le stack depuis les fichiers du projet (voir "Détection du stack") plutôt que de demander quand vous le pouvez.
Processus
1. Détecter le stack
Utilisez le tableau dans "Détection du stack". Lisez la section correspondante de references/adapters.md avant d'écrire des fichiers ; elle ne couvre que ce qui diffère des recettes simples dans les autres références.
2. Faire un inventaire
Avant tout balisage, notez :
- Chaque H2 de
copy.mdet la<section>qu'il devient, avec sonid. - Chaque nom de jeton dans
tokens.css. Vous utiliserez ces noms et aucun autre pour la couleur, la police, l'espacement et le rayon. - Chaque image demandée par la direction, son ratio d'aspect, et si le fichier existe.
- L'action de conversion du brief : une URL externe (un lien, pas de formulaire), ou un formulaire avec ses champs et son endpoint. Avec l'endpoint
none yet, le formulaire poste vers/api/leadet cet écart va dans la remise (étape 11). - Le Domaine (connu ou
unknown) et les Routes de contact, dont le head, le footer et/form-error/ont besoin.
3. Écrire le head
Titre, description, canonique, Open Graph et carte sociale, jeu de favicons, theme-color, lang, données structurées. Les modèles et règles sont dans references/seo-meta.md. Écrivez le titre et la description depuis copy.md ; un titre par défaut comme celui du starter du framework est un indice.
4. Charger les polices
Auto-hébergez les fichiers WOFF2 nommés dans la direction, déclarez @font-face avec des noms de famille qui correspondent exactement aux stacks dans tokens.css, ajoutez un fallback métriquement adapté, et préchargez uniquement les un ou deux fichiers utilisés au-dessus de la ligne de flottaison. references/performance.md contient la recette et un script testé qui calcule les valeurs de fallback. Une page qui nomme une police et ne la charge jamais, ou qui utilise system-ui comme fallback, s'affiche différemment sur chaque machine.
5. Construire le squelette de la mise en page
Chaque bande de la page est une <section class="section"> avec un <div class="container"> à l'intérieur. Les deux ne partagent jamais un même rôle :
/* La section possède le rythme vertical, le conteneur possède la largeur et les gouttières. */
.section { padding-block: var(--space-section-open); }
.container {
inline-size: min(100% - 2 * var(--space-gutter), var(--space-content-max));
margin-inline: auto;
}
Les noms de jetons ci-dessus sont des exemples ; utilisez les noms dans votre tokens.css. references/css.md liste chaque rôle de jeton que les recettes supposent et quoi faire lorsque votre fichier n'a pas de jeton pour l'un d'eux. Le conteneur ne définit aucun padding, donc aucun ordre de règle ou spécificité ne peut effacer l'espacement de la section. N'utilisez jamais la propriété raccourcie padding ou margin sur une classe de section ou de conteneur : une propriété raccourcie définit les deux axes et remplace silencieusement celui que l'autre classe a défini. C'est la règle qui supprime le bug 1. references/css.md montre la version cassée à côté de celle-ci, ainsi que les cas de pleine largeur et de ligne fine.
6. Construire les sections
- Utilisez des éléments sémantiques :
header,nav,main,section,footer,olpour les étapes,dloutablepour les spécifications,figurepour les médias avec légende. - Un
h1, dans le hero. Chaque section commence par unh2tiré decopy.md. Ne sautez pas de niveaux. - Disposez chaque section selon sa ligne dans
direction.md. Lorsque la direction laisse la forme ouverte, choisissez parmi les recettes dansreferences/css.md; le nombre et la forme des blocs suivent le contenu, donc trois cartes égales n'apparaissent que lorsque le contenu est composé de trois éléments égaux. - Utilisez les jetons pour chaque couleur, police, taille, espace et rayon. Ne redéclarez jamais un jeton dans le CSS de la page. Si une valeur dont vous avez besoin n'a pas de jeton, composez-la à partir de jetons (
calc(),color-mix()) et listez-la dans la remise afin que la direction puisse l'ajouter. - Utilisez des tailles fluides avec
clamp(), des propriétés logiques, la couleuroklch()avec les fallbacks dansreferences/css.md, et les requêtes de conteneur pour les composants qui changent de forme avec leur propre largeur.
7. Placer les médias
Les images réelles reçoivent width et height, un texte alt qui décrit ce qu'elles contiennent, des formats modernes avec un fallback, et fetchpriority="high" uniquement sur l'image du hero (references/performance.md). Un élément qui n'existe pas encore devient une boîte placeholder visible et étiquetée au ratio d'aspect final, avec un texte comme [PLACEHOLDER : photo, le banc de l'atelier vu du dessus, 3:2]. Ne donnez pas à la boîte role="img" : elle annoncerait une photographie qui n'existe pas. Donnez à chaque placeholder le ratio, la largeur et le fond que la direction donne à cette image, de sorte que les cadres montrent la mise en page prévue plutôt qu'une rangée de boîtes en pointillés identiques (references/css.md, Placeholders de médias). Ne dessinez jamais un écran de produit factice et ne le présentez pas comme le produit.
8. Construire l'action de conversion
L'action de conversion du brief décide ce que vous construisez :
- Une URL externe (page de paiement, page de réservation, app store) : l'action est un lien,
<a class="button" href="https://...">avec le libellé decopy.md. Il n'y a pas de formulaire, pas deform.js, et pas de page/thanks/ou/form-error/; passez le reste de cette étape. Si le brief dit que le clic doit être compté,landing-skills:landing-launchajoute la balise. - Un formulaire avec un endpoint que l'utilisateur possède déjà : le formulaire poste vers cette URL et le placeholder
/api/leadn'est pas utilisé. Construisez les pages de résultat uniquement si cet endpoint redirige vers elles ; sinon, dites dans la remise où l'endpoint envoie le visiteur. - Un formulaire avec l'endpoint
none yet: le formulaire poste vers le placeholder/api/lead, quelanding-skills:landing-launchconstruit comme un Worker.
Pour un formulaire, lisez references/forms-a11y.md. Les parties non négociables :
<form action="..." method="post">avec l'endpoint du brief, ouaction="/api/lead"avec un commentaire HTML à côté indiquant que l'endpoint n'existe pas encore, listé dans la remise.- Chaque champ a un
name, un<label>visible, le bontypeetautocomplete, et une astuce liée avecaria-describedbylorsque le format nécessite une explication. - Sans JavaScript, le navigateur poste le formulaire et l'endpoint répond avec une redirection
303vers l'une des deux pages statiques que vous construisez maintenant :/thanks/et/form-error/. Une fois quelanding-skills:landing-launchajoute Turnstile, un visiteur sans JavaScript n'a pas de jeton et arrive toujours sur/form-error/, donc cette page doit offrir un autre moyen de contacter, tiré des routes de contact du brief. - Expédiez toujours
form.jsdepuisreferences/forms-a11y.mdcomme amélioration progressive. Le formulaire fonctionne sans lui ; le fichier fait toujours partie de la build, carlanding-skills:landing-motionétend les états qu'il définit etlanding-skills:landing-launchles vérifie. Il n'affiche le succès que lorsque la réponse est un 2xx et que son corps JSON ditok: true. Un 2xx seul prouve seulement que quelque chose a répondu :fetchsuit une redirection et signale la page sur laquelle il atterrit comme 200, et un hébergeur statique peut répondre à un POST avec une page HTML ordinaire. Les deux sont arrivés lors des tests, et les deux sont des échecs. En cas d'échec, le script le dit et conserve ce que le visiteur a tapé. Ne réinitialisez jamais le formulaire et n'affichez pas "Merci" avant que le serveur n'ait confirmé.
9. Atteindre le seuil d'accessibilité
Lien d'évitement, points de repère, un nav dont les liens pointent vers des id de sections réels, le logo liant vers /, un style de focus visible sur chaque élément interactif, des cibles d'au moins 44 x 44 px, et une vérification de contraste de chaque paire de texte et d'arrière-plan que la page affiche réellement : texte du corps sur chaque surface, légendes, astuces, texte placeholder, texte sur l'accent. Les détails et les chiffres sont dans references/forms-a11y.md. Une navigation qui cache ses liens sur mobile sans remplacement échoue à ce seuil ; laissez plutôt les liens passer à la ligne.
10. Laisser le mouvement de côté
Sous mouvement réduit, c'est le mouvement qui est réduit, jamais le feedback, donc n'écrivez aucune règle globale qui annule les transitions. Construisez chaque élément dans son état final et visible. Pas d'animations d'entrée, pas de opacity: 0 en attendant un script, pas de bibliothèques de défilement.
Pour chaque moment nommé dans la direction Motion and 3D intent, laissez un substitut : une image fixe, ou un placeholder étiqueté, à la taille et au ratio d'aspect finaux du moment, afin que la mise en page ne bouge pas lorsque landing-skills:landing-motion monte la version réelle. Marquez-le avec data-moment="<nom>", en utilisant le nom court que la direction donne à ce moment ; le mouvement trouve sa cible par cet attribut. Le substitut est complet sans mouvement : une image réelle avec un texte alt, ou un texte placeholder qui dit ce que le moment montre.
<div class="hero__media" data-moment="vue-explosee">
<img src="/img/vue-explosee-poster.jpg" width="1600" height="1000" alt="Les couches de l'appareil écartées : boîtier, carte, batterie, objectif">
</div>
Lorsque l'intention est none, n'ajoutez aucun élément data-moment.
11. Vérifier et remettre
Exécutez "Définition de fait". Ensuite, dites à l'utilisateur, dans une courte liste :
- ce qui a été construit et où (fichiers, dossier de sortie), et le stack résolu écrit dans le champ Stack du brief s'il indiquait
detect, - chaque
[PLACEHOLDER: ...]toujours sur la page et chaque ressource à fournir, - l'action de conversion telle que construite : un lien vers une URL externe, un formulaire postant vers l'endpoint de l'utilisateur, ou un formulaire postant vers
/api/lead, qui n'existe pas encore, - chaque champ que le formulaire soumet, une ligne chacun : son
name, son type (email,tel,text,textarea), s'il estrequired, et sonmaxlengthdepuis le balisage.landing-skills:landing-launchconfigure la validation de son Worker, les limites de longueur, le stockage et la limite de taille de requête à partir de cette liste, et refuse un champ dont il n'a pas été informé, - les valeurs composées parce qu'aucun jeton n'existait, et chaque jeton optionnel que
tokens.cssn'avait pas avec le fallback que les recettes ont utilisé pour lui, - le domaine de production si le brief dit
unknown, et les balises URL omises à cause de cela (canonique,og:url,og:image, sitemap), - les routes de contact que le brief a laissées
unknown, que le footer et/form-error/affichent comme placeholders, - chaque fichier de police qui n'a pas été sous-ensemble, avec sa taille en octets,
- chaque vérification de la Définition de fait qui n'a pas été exécutée, marquée "non exécutée" avec la raison,
- chaque moment de
Motion and 3D intent: son nomdata-momentet où se trouve son substitut (section et élément), ou "none" lorsque l'intention estnone, - la prochaine compétence :
landing-skills:landing-motionlorsque la directionMotion and 3D intentnomme un moment, puislanding-skills:landing-review, puislanding-skills:landing-launchpour l'hébergement et l'endpoint du formulaire.
Détection du stack
Vérifiez la racine du projet dans cet ordre et arrêtez-vous à la première correspondance. Le champ Stack dans brief.md décide quand le dossier du projet est vide.
Une fois le stack résolu, écrivez-le : si le champ Stack du brief dit detect, remplacez ce seul mot par le stack résolu (par exemple Astro, ou HTML et CSS simples) et ne modifiez rien d'autre dans landing/brief.md. Les compétences ultérieures lisent le champ et ne devraient pas rencontrer un mot non résolu. Un stack nommé par l'utilisateur reste tel qu'écrit. Quand il n'y a pas de landing/brief.md, n'en créez pas.
| Signal dans le projet | Stack | Section de l'adaptateur |
|---|---|---|
astro.config.mjs (ou .ts, .js), ou astro dans les dépendances package.json | Astro | Astro |
…
[tronqué pour la traduction]
