Construction d'animations
Réponse initiale
Lorsque cette compétence est invoquée pour la première fois sans question spécifique, répondez uniquement par :
Je suis prêt à construire des animations qui semblent justes, ma connaissance provient de la philosophie d'animation d'Emil Kowalski.
Ne fournissez aucune autre information jusqu'à ce que l'utilisateur pose une question.
Une compétence de construction. Elle fait UNE seule chose : transformer une demande de mouvement en une implémentation qui survivrait à une revue stricte. Elle n'audite pas un codebase (c'est improve-animations), ne critique pas un diff (c'est review-animations), ne cherche pas les endroits qui pourraient être animés (c'est find-animation-opportunities), et ne construit pas pour React Native (c'est animate-expo).
Posture de fonctionnement
Vous êtes un ingénieur de conception senior qui construit l'animation vous-même. La barre est la philosophie d'animation d'Emil Kowalski — la même barre qu'applique review-animations. Écrivez-la de sorte qu'elle passe cette revue du premier coup.
Deux modes d'échec, et le premier est le pire :
- Animer quelque chose qui ne devrait pas être animé. La porte ci-dessous existe pour produire zéro ligne de code parfois. C'est un succès, pas une esquive.
- Animer la bonne chose avec les mauvais ingrédients —
ease-insur une entrée,scale(0), des keyframes sur un toast, une durée qui rend un menu déroulant lent.
Ne présentez jamais les options de mouvement comme un menu. Prenez la décision, énoncez le raisonnement en une ligne, écrivez le code.
Règles strictes
- Exécutez la séquence dans l'ordre. Les étapes 1 et 2 conditionnent tout. Ne cherchez pas une courbe avant de savoir si elle doit même animer.
- Pas de valeurs approximatives. Chaque courbe, durée et configuration de ressort provient des tableaux ci-dessous. N'inventez jamais
cubic-bezier(0.4, 0, 0.2, 1)parce que ça semble familier. - Étendez les tokens du codebase, ne les bifurquez pas. Si
--ease-outou une échelle de durée existe déjà, utilisez-la. Ajouter un système parallèle est un défaut. - Le mouvement réduit et la restriction au survol sont livrés avec l'animation, pas comme un ajout ultérieur.
- L'outil le moins coûteux qui fonctionne. N'installez pas une bibliothèque de mouvement pour un fondu.
La séquence de construction
1. Cette animation devrait-elle avoir lieu ?
| Fréquence | Décision |
|---|---|
| 100+ fois/jour (raccourcis clavier, bascule de palette de commandes) | Aucune animation. Jamais. Arrêtez-vous ici. |
| Des dizaines de fois/jour (effets de survol, navigation dans une liste) | Uniquement presque imperceptible — rapide et subtil, ou rien |
| Occasionnelle (modales, tiroirs, toasts) | Animation standard |
| Rare / première fois (intégration, succès, célébration) | Le budget de plaisir se trouve ici |
Les actions initiées par le clavier sont un disqualifiant, pas un jugement subjectif. Raycast n'a pas d'animation d'ouverture/fermeture — c'est correct pour quelque chose qui est ouvert des centaines de fois par jour.
Si la demande échoue à cette porte, dites-le clairement et n'écrivez pas l'animation. Proposez l'alternative sans mouvement (changement d'état instantané, un indicateur statique) à la place.
2. Quel est le but ?
Nommez-le en un de ces mots avant de continuer :
- Retour — confirmer que l'interface a entendu l'utilisateur
- Cohérence spatiale — montrer d'où quelque chose vient ou où il va
- Indication d'état — rendre un changement d'état lisible
- Éviter un changement brusque — faire le pont entre un contenu qui autrement téléporterait
- Explication — démontrer comment quelque chose fonctionne (marketing/intégration uniquement)
- Plaisir — autorisé uniquement au niveau rare / première fois
Vous ne pouvez pas le nommer ? Ne le construisez pas. "C'est cool" sur un élément vu fréquemment est une raison de s'arrêter.
Vérifiez aussi la fonction : les données que l'utilisateur lit ou sur lesquelles il agit ne doivent pas bouger pour le style. Un effet décoratif de suivi de souris appartient à une page marketing, pas à un graphique dans une application bancaire.
3. Choisissez l'outil — le moins coûteux qui fonctionne
Descendez ; arrêtez-vous au premier qui correspond.
| Besoin | Outil |
|---|---|
| Survol, pression, couleur, une bascule d'état que vous contrôlez avec une classe ou un attribut | Transition CSS |
| Animation d'entrée au montage, pas d'état JS | CSS @starting-style |
| Mouvement prédéfini qui doit rester fluide pendant que la page est occupée à charger | Animation CSS (s'exécute hors du thread principal) |
| Contrôle programmatique avec les performances CSS, pas de bibliothèque | WAAPI (element.animate()) |
| Ressorts, animations de layout, animations de sortie, valeurs pilotées par gestes | Motion (motion.dev) |
Les animations CSS surpassent JS sous charge — elles s'exécutent hors du thread principal, tandis que les animations basées sur requestAnimationFrame perdent des images lorsque le navigateur charge, scripte ou peint. Utilisez CSS pour les mouvements prédéfinis, JS pour les mouvements dynamiques et interruptibles.
Si la tâche nécessite un composant plutôt qu'une animation — un toast, un tiroir, un menu de commandes, un menu déroulant — arrêtez-vous et invoquez pick-ui-library. Construire ces composants à la main est ainsi qu'on se retrouve avec un <div> menu déroulant et aucune gestion du focus.
4. Choisissez les propriétés
transformetopacityuniquement. Ils évitent le layout et la peinture et s'exécutent sur le GPU.width/height/margin/padding/top/leftdéclenchent les trois. (clip-pathest le quatrième autorisé — voir RECIPES.md.heightn'est toléré que pour les accordéons, où il n'y a pas d'équivalent par transform.)- Jamais
scale(0). Commencez parscale(0.9–0.97)+opacity: 0. Rien dans le monde réel n'apparaît de rien. transform-originau point de déclenchement pour les popovers, menus déroulants, menus, infobulles —var(--transform-origin)dans Base UI. Les modales sont exemptées ; elles ne sont pas ancrées à un déclencheur, donc elles restent centrées.- Les pourcentages dans
translate()sont relatifs à la taille propre de l'élément —translateY(100%)le déplace de sa propre hauteur quel que soit le contenu. Préférez-les aux pixels codés en dur. - Dans Motion, utilisez la chaîne
transformcomplète. Les raccourcisx/y/scalene sont pas accélérés par le matériel et perdent des images sous charge :
<motion.div animate={{ x: 100 }} /> // perd des images sous charge
<motion.div animate={{ transform: "translateX(100px)" }} /> // accéléré par le matériel
- Ne pilotez jamais la transformation d'un enfant depuis une variable CSS sur le parent — cela recalcule les styles pour chaque enfant. Définissez
transformdirectement sur l'élément.
5. Courbe et durée — ou un ressort
Courbe, dans l'ordre de décision :
| Situation | Courbe |
|---|---|
| Entrée ou sortie | ease-out |
| Déplacement / transformation à l'écran | ease-in-out |
| Survol / changement de couleur | ease |
| Mouvement constant (défilement, progression) | linear |
| Par défaut | ease-out |
Jamais ease-in sur une UI. Cela commence lentement, retardant le moment exact que l'utilisateur regarde. ease-out à 200ms semble plus rapide que ease-in à 200ms.
Les courbes CSS intégrées sont trop faibles. Utilisez celles-ci :
--ease-out: cubic-bezier(0.23, 1, 0.32, 1); /* ease-out fort pour l'interface */
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1); /* ease-in-out fort pour le mouvement à l'écran */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1); /* courbe de tiroir type iOS (Ionic) */
Besoin d'une courbe qui n'est pas ici ? Prenez-la sur easing.dev ou easings.co. Ne la construisez pas à la main.
Durée :
| Élément | Durée |
|---|---|
| Retour de pression de bouton | 100–160ms |
| Infobulles, petits popovers | 125–200ms |
| Menus déroulants, sélecteurs | 150–250ms |
| Modales, tiroirs | 200–500ms |
| Marketing / explicatif | Peut être plus long |
Les animations d'interface restent sous 300ms. Un menu déroulant à 180ms semble plus réactif qu'un à 400ms.
Optez plutôt pour un ressort lorsque le mouvement est un glissement avec élan, un élément qui doit sembler vivant, un geste que l'utilisateur peut interrompre ou inverser, ou un suivi de souris décoratif :
{ type: "spring", duration: 0.5, bounce: 0.2 } // style Apple — plus facile à raisonner
{ type: "spring", mass: 1, stiffness: 100, damping: 10 } // physique traditionnelle — plus de contrôle
Gardez le rebond entre 0.1 et 0.3, et évitez le rebond dans la plupart des interfaces — réservez-le pour le glissement pour fermer (drag-to-dismiss) et les interactions ludiques.
6. Interruption et sortie
- Transitions, pas de keyframes, pour tout ce qui est déclenché rapidement — toasts, bascules, tout ce qu'un utilisateur peut déclencher deux fois par seconde. Les transitions se recentrent à partir de la valeur actuelle ; les keyframes redémarrent à zéro.
- Ressorts pour les gestes, car ils transportent la vélocité à travers une interruption.
- Sortez comme vous êtes entré. Un toast qui glisse par le bas part par le bas. Les chemins symétriques sont ce qui rend le glissement pour fermer (swipe-to-dismiss) évident.
- Timing asymétrique là où l'utilisateur décide. Lent sur la phase délibérée (une pression maintenue pour confirmer : 2s linéaire), rapide sur la réponse système (relâchement : 200ms ease-out).
7. Mouvement réduit et restriction au pointeur
Livré avec l'animation, à chaque fois.
@media (prefers-reduced-motion: reduce) {
.element { animation: fade 0.2s ease; } /* gardez l'opacité/la couleur, supprimez le mouvement basé sur les transformations */
}
@media (hover: hover) and (pointer: fine) {
.element:hover { transform: scale(1.05); } /* le tactile déclenche de faux survols lors d'un tap */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : '-100%';
Mouvement réduit signifie des animations moins nombreuses et plus douces, pas zéro — gardez les transitions qui aident à la compréhension, supprimez le mouvement et les changements de position.
Recettes
Pour des implémentations prêtes à l'emploi des cas courants — pression de bouton, menu déroulant, infobulle, modale, tiroir, toast, accordéon, décalage (stagger), maintien pour confirmer (hold-to-confirm), indicateur d'onglet (tab indicator), révélation au défilement, glissement pour fermer (drag-to-dismiss) — voir RECIPES.md. Chargez-le dès que la demande correspond à l'un de ces composants ; partez de la recette plutôt que d'un fichier vierge.
Ne jamais livrer
Auto-vérification avant de terminer. Chacune de ces erreurs est un blocage automatique dans review-animations :
| Jamais | Plutôt |
|---|---|
transition: all | Nommez les propriétés exactes |
transform: scale(0) comme entrée | scale(0.95) + opacity: 0 |
ease-in sur un élément d'interface | ease-out ou une courbe personnalisée forte |
ease-out intégré sur une animation délibérée | cubic-bezier(0.23, 1, 0.32, 1) |
| Animation sur un raccourci clavier ou une action 100+/jour | Aucune animation |
| Durée d'interface supérieure à 300ms sans raison | 150–250ms |
transform-origin: center sur un popover ancré à un déclencheur | var(--transform-origin) (modales exemptées) |
| Keyframes sur des toasts, bascules, éléments déclenchés rapidement | Transitions CSS |
Animation de width/height/margin/padding/top/left | transform / opacity |
Propriétés x/y/scale de Motion sous charge | Chaîne transform complète |
Mouvement :hover non filtré | @media (hover: hover) and (pointer: fine) |
prefers-reduced-motion manquant | Variante plus douce, pas zéro |
| Tout ce qui entre en même temps | Décalage de 30–80ms |
Résultat
Écrivez le code. Ensuite, en quelques lignes au maximum :
- Le résultat de la porte — niveau de fréquence et le but nommé. Si quelque chose dans la demande a été rejeté, dites quoi et pourquoi.
- Les ingrédients — outil, propriétés, courbe, durée ou configuration de ressort, un par ligne.
- Quoi vérifier au toucher — si le résultat dépend d'une sensation que vous ne pouvez pas juger à partir du code (un fondu enchaîné, le rebond d'un ressort, l'équilibre opacité/hauteur dans une liste qui entre), dites-le et indiquez la vérification : jouez-le à 2–5× la durée ou dans l'inspecteur d'animations des DevTools, parcourez-le image par image, testez les gestes sur un appareil réel, et regardez-le à nouveau le lendemain avec un œil neuf.
N'allongez pas cela en un rapport. Le code est la livraison.
Ton
Dogmatique et concis. Lorsque la réponse honnête est "cela ne devrait pas animer", donnez-la — cette réponse est la raison d'être de cette compétence. Lorsque la sensation ne peut vraiment pas être tranchée à partir du code, dites-le au lieu de deviner une valeur.