Landing motion
Ajoutez du mouvement et de la 3D à une page d'atterrissage qui fonctionne déjà sans eux. Chaque effet que vous ajoutez a un objectif déclaré, une variante pour les mouvements réduits et un repli qui laisse la page complète. La page avant que vous ayez commencé est le repli : si un script échoue, si un navigateur ne supporte pas une fonctionnalité ou si le visiteur demande moins d'animations, il obtient cette page, pas une page blanche.
Entrées
landing/direction.md, sectionIntention de mouvement et de 3D. C'est le brief pour votre travail. Il indiquenone, ou nomme chaque moment et son objectif. Implémentez ce qu'il nomme. N'ajoutez pas de moments qu'il ne nomme pas.- La page statique construite par
landing-skills:landing-build, ou toute page existante. Elle doit afficher tout le contenu textuel et l'action de conversion avec JavaScript désactivé. Vérifiez d'abord cela : si ce n'est pas le cas, corrigez-le avant d'ajouter du mouvement, car chaque recette ici suppose que la page statique est le repli. landing/tokens.csssi présent. Utilisez ses couleurs dans les shaders et les replis. Placez les jetons de mouvement (durées, easings) dans votre propre feuille de style ; laisseztokens.csstel que la direction artistique l'a écrit.
Lorsqu'une entrée est manquante :
- Pas de
direction.md: demandez à l'utilisateur ce qui devrait bouger et pourquoi. Si vous ne pouvez pas demander, la valeur par défaut estnone(voir « Décider ce qui bouge ») ; dites-le dans votre résumé. - Pas de page statique : arrêtez-vous et construisez-en d'abord une (
landing-skills:landing-build), ou demandez-la. Du mouvement superposé sur une page qui n'existe qu'en JavaScript, c'est ainsi qu'une scène 3D échouée entraîne le titre principal et l'appel à l'action vers le bas. - La stack : lisez
package.json. React (Vite, Next) reçoit les variantes React lorsqu'une recette en a une ; tout le reste reçoit la variante HTML, CSS et JavaScript pur. Une application React côté client uniquement (tout rendu dans un#rootvide) échoue par construction à la vérification sans JavaScript : le texte doit d'abord être dans le HTML, via un rendu serveur, un prérendu ou le motif d'îlot dansreferences/webgl-3d.md.
Décider ce qui bouge
Partez de l'intention dans direction.md. Écrivez, pour chaque moment qu'il nomme : l'élément, le rôle (entrée, retour d'information, lié au défilement, ambiant ou 3D interactif), et ce que le visiteur en apprend. Si vous ne pouvez pas terminer cette phrase, supprimez le moment.
none est une réponse valable, souvent la bonne, et la valeur par défaut lorsque l'intention est manquante. De nombreuses pages sont complètes sans aucun mouvement au-delà des états de retour d'information, surtout lorsque des photographies ou du texte les portent ; une page avec presque aucun mouvement n'y perd rien.
Sous none, c'est une courte vérification, pas un nouveau travail. landing-skills:landing-build écrit déjà les états de survol, de focus, d'appui et de désactivation, ainsi qu'un script de formulaire avec les états d'envoi, de succès et d'erreur. Ouvrez la page dans un navigateur et confirmez quatre choses :
- La tabulation montre un anneau de focus visible sur chaque lien, bouton et champ.
- Les états de survol et d'appui répondent sur les boutons et les liens.
- Après une soumission de formulaire, le message de statut apparaît et prend le focus (
references/interaction.md, « Retour d'information de soumission de formulaire », ajoute ceci si c'est manquant). - Rien ne bouge tout seul : pas de lecture automatique, pas de boucle, pas de révélation.
Ajoutez éventuellement un minutage aux états de survol et d'appui (references/interaction.md, « États de survol et d'appui »). Puis arrêtez-vous. Si vous n'avez pas pu ouvrir un navigateur, dites-le et listez chacun des quatre comme « non exécuté » ; ne signalez pas la page comme vérifiée.
Lorsque l'intention nomme des moments :
- Un moment signature par page. La séquence du héros, la démo du produit, l'objet 3D. Tout le reste est plus calme que lui.
- Variez par rôle, jamais par section. Le retour d'information est rapide (100 à 200 ms), les entrées sont plus lentes, le mouvement lié au défilement suit le scroll. Appliquer le même fade-up, easing et décalage à chaque section est le motif de page générée le plus reconnaissable, et il n'apprend rien au visiteur.
- La plupart du contenu ne bouge pas. Le texte que le visiteur lit ne bouge jamais : pas de parallaxe sur les paragraphes, pas de révélation qui cache un bloc jusqu'à ce qu'il soit défilé jusqu'à lui.
- Démontrez, ne décorez pas. Le mouvement qui montre comment le produit fonctionne (une séquence d'états, une vue éclatée, un avant et après) vaut son coût. Le mouvement qui dit seulement « cette page est animée » ne le vaut pas.
Lisez references/foundations.md avant d'écrire un quelconque mouvement. Il contient les durées, les easings et la liste des motifs qui semblent générés, chacun avec quoi faire à la place.
Adapter les recettes à la page
Les recettes se fixent à la page qui existe ; elles ne la restylisent pas.
- La page statique de
landing-skills:landing-buildlaisse un substitut pour chaque moment que la direction nomme : une image d'affiche ou un espace réservé étiqueté à sa taille finale. Marquez cet élément avecdata-moment="<name>"(le nom de « Intention de mouvement et de 3D ») si le build ne l'a pas fait, et fixez la recette à lui : ajoutez la classe de conteneur de la recette à cet élément, ou sélectionnez-le par l'attribut. - La section Code de chaque recette commence par une ligne nommant les classes qu'elle ajoute, comme nouvelles pour cette compétence, et les classes du build qu'elle utilise inchangées. Ajoutez les nouvelles classes ; ne redéfinissez jamais les propres classes du build (
.hero,.hero__title,.button,.section,.split, et le reste). Lorsqu'une recette nécessite une mise en page que l'élément du build n'a pas, enveloppez-le dans un nouvel élément de votre cru. - Utilisez les jetons du build (
--color-*,--space-*,--radius-control) pour toute couleur ou taille dont une recette a besoin, jamais une nouvelle valeur littérale.
Choisir une recette
Choisissez l'échelon le plus bas qui produit l'effet : CSS, puis un petit script, puis GSAP ou Motion, puis WebGL. Chaque recette a « Quand utiliser », « Quand éviter », « Code », « Mouvement réduit » et « Coût » ; les recettes 3D ajoutent « Repli ».
| Besoin | Lire |
|---|---|
| Durées, easings, ressorts, décalage, ce qui semble généré | references/foundations.md |
| Entrée du héros, titre en texte éclaté, révélation masquée par clip-path ou découpée, compteur | references/entrances-text.md |
| Progression du défilement, entrée liée au scroll, narration sticky, sections épinglées ou horizontales, défilement fluide | references/scroll.md |
| Couches de profondeur au défilement, profondeur du pointeur, parallaxe d'image ou de vidéo, parallaxe dans React | references/parallax.md |
| Minutage du survol et de l'appui, retour d'information de soumission de formulaire, bouton magnétique, suiveur de curseur, inclinaison, glissement, un cadran pas à pas, transitions de vue | references/interaction.md |
| Objet 3D à faire pivoter, vue éclatée au défilement, un contexte pour deux étapes séparées, modèle glTF, îlot React Three Fiber | references/webgl-3d.md |
| Quoi importer et laisser de côté, fichiers de décodeur inutilisés dans le build, création d'affiches, compression de modèles et textures | references/webgl-assets.md |
| Chemin de caméra piloté par le défilement, fond shader, particules, distorsion d'image, WebGPU | references/webgl-effects.md |
| Quelle bibliothèque, sa licence et sa taille, quand CSS suffit | references/libraries.md |
| Variantes à mouvement réduit, repli WebGL, mise en pause, budgets, protection du héros | references/safety.md |
Pour tout travail 3D ou WebGL, lisez d'abord references/safety.md (les recettes de scène importent ses aides), puis « Avant toute scène » dans references/webgl-3d.md, puis seulement la recette dont vous avez besoin.
Rails de sécurité
Ceux-ci s'appliquent à chaque effet. references/safety.md contient le code.
- Le héros s'affiche sans JavaScript. Le titre principal, le lead et l'appel à l'action sont dans le HTML et visibles au premier affichage. Ne commencez pas le titre principal ou l'image du héros à une opacité de 0 : un élément à opacité 0 n'est pas un candidat au Largest Contentful Paint jusqu'à ce qu'il s'affiche, donc une longue entrée retarde le LCP. Chargez le code 3D après l'événement de chargement, avec une image d'affiche à sa place jusqu'à ce que la première image soit dessinée.
- Réduisez, ne supprimez pas. La propre déclaration de la direction concernant le mouvement réduit l'emporte ; ce qui suit est la valeur par défaut. Sous
prefers-reduced-motion: reduce, supprimez le parallaxe, l'animation de défilement frotté, les boucles de lecture automatique et les grands déplacements. Conservez les retours d'information et les fondus courts. Une scène 3D se charge uniquement si elle est statique et pilotée par l'utilisateur ; la sauter et afficher les affiches est le choix correct le plus simple. Écrivez la variante réduite par effet, et écoutez le changement de préférence pendant que la page est ouverte. Une règle globale qui met à zéro la durée de chaque animation est elle-même un signe reconnaissable. - WebGL est optionnel. Vérifiez la présence d'un contexte avant de télécharger un quelconque code 3D. Dans React, enveloppez le canvas dans une limite d'erreur. Gérez la perte de contexte. Le repli est une image réelle, jamais une boîte vide.
- Un seul canvas. Un deuxième contexte WebGL double la mémoire et le travail GPU. Placez les moments 3D liés dans un seul canvas sticky.
- Rien ne s'exécute hors écran. Les canvases, vidéos et boucles s'arrêtent lorsqu'ils sont hors de la vue ou lorsque l'onglet est caché.
- Le défilement ne ré-affiche jamais un framework. Lisez la position de défilement dans la boucle d'images ou laissez CSS le piloter. Pas de
setStatepar événement de défilement ou par image. - Animez uniquement
transformetopacity. Jamaistop,left,widthouheight. - Auto-hébergez chaque ressource. Les modèles, décodeurs, cartes d'environnement et polices proviennent de votre origine. Certaines aides utilisent par défaut des CDN tiers ; remplacez-les.
- L'interaction a un chemin clavier. Tout ce que le pointeur peut faire pivoter, glisser ou basculer, le clavier le peut aussi.
Définition de terminé
Vérifiez chaque élément dans un navigateur. Un outil de navigateur est préférable ; sans lui, utilisez le script de capture de landing-skills:landing-review pour des captures d'écran et dites quelles vérifications vous n'avez pas pu faire.
- Chaque moment nommé dans « Intention de mouvement et de 3D » existe, et rien d'autre n'a été ajouté au-delà des états de retour d'information.
- Avec JavaScript désactivé : tout le texte et l'action de conversion sont présents.
- Avec mouvement réduit émulé : la page est complète et lisible, rien ne se lit automatiquement, pas de parallaxe, pas de frotté ; les états de retour d'information répondent toujours.
- Avec WebGL désactivé (drapeau Chromium
--disable-webgl) : l'affiche ou l'image statique s'affiche là où se trouverait la scène, et le texte du héros et l'appel à l'action ne sont pas touchés. - Le texte du héros est visible avant que le code 3D ne soit chargé (limitez le réseau pour vérifier).
- Aucune section ne partage la même animation d'entrée par défaut ; le moment signature est le seul important.
- Les canvases cessent de dessiner lorsqu'ils sont défilés hors de la vue (panneau Performance, ou un compteur d'appels de dessin comme dans
references/safety.md). - Le panneau réseau ne montre aucune requête vers un hôte tiers pour des ressources 3D.
- Dans une build de production, three.js et autres codes 3D sont dans un chunk qui ne fait pas partie du bundle d'entrée.
- Clavier : chaque rotation, glissement et basculement fonctionne avec les touches ; le focus reste visible.
Le détecteur de signes detect-tells.mjs appartient à landing-skills:landing-review et est une aide optionnelle. S'il est disponible, exécutez-le sur la page ; il signale les signes au niveau du motif, tels que les attributs de révélation standard et le coupe-circuit de mouvement réduit. La vérification requise est visuelle : scroll la page entière une fois avec le mouvement activé et une fois avec mouvement réduit, et confirmez que chaque chose en mouvement a le rôle que vous avez écrit pour elle.
Terminez par un court résumé pour l'utilisateur : chaque moment ajouté et son objectif, les bibliothèques ajoutées avec leurs licences, les ressources encore nécessaires (par exemple un modèle réel pour remplacer un substitut primitif, une image d'affiche), et toute vérification que vous n'avez pas pu exécuter.