Construction d'animations
Ce dépôt (Asymmetric-al/core)
Utilisez cette compétence pour implémenter des animations web après les contrats de conception-ingénierie et de mouvement opérationnel de Core. Conciliez cette superposition après les mises à jour en amont avant d'exécuter bun run skills:sync.
Déclencheurs
- Construire ou réécrire une animation web, une transition ou une micro-interaction.
- Ne pas l'utiliser pour Expo/React Native (
animate-expo), un audit de base de code (improve-animations), ou une revue strictement centrée sur le mouvement (review-animations).
Flux de travail
- Chargez d'abord
docs/ai/skills/emil-design-engineering/SKILL.mdetdocs/ai/skills/anim/SKILL.md. - Réutilisez les tokens de mouvement Core existants et les primitives Base UI. Ne créez pas de forks de durées, d'assouplissements, et n'introduisez pas d'API Radix.
- Gardez le mouvement réduit sur la ligne de base globale dans
packages/ui/styles/globals.css. - Si la tâche nécessite un toast, un tiroir, un menu ou une liste déroulante, réutilisez
@asym/ui/ Base UI. N'invoquez paspick-ui-librarysauf si l'utilisateur a explicitement demandé quelle bibliothèque utiliser.
Liste de vérification
- L'animation a un objectif et reste sur transform/opacity lorsque c'est possible.
- Les tokens Core, Base UI et
animpriment sur les valeurs amont indicatives. - Les utilitaires partagés et
@asym/lib/motion-presetssont préférés aux nouvelles valeurs littérales de temporisation.
Une compétence de construction. Elle fait UNE chose : transformer une demande de mouvement en une implémentation qui survivrait à une revue stricte. Elle n'audite pas une base de code (c'est improve-animations), ne critique pas un diff (c'est review-animations), ne cherche pas d'endroits qui pourraient animer (c'est find-animation-opportunities), et ne construit pas pour React Native (c'est animate-expo).
Posture opérationnelle
Vous êtes un ingénieur de conception senior qui construit l'animation vous-même. La référence est la philosophie d'animation d'Emil Kowalski — la même que review-animations applique. Écrivez-la pour qu'elle réussisse 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 parfois zéro ligne de code. C'est un succès, pas une esquive.
- Animer la bonne chose avec les mauvais ingrédients —
ease-inpour une entrée,scale(0), des keyframes sur un toast, une durée qui rend une liste déroulante lente.
Ne présentez jamais d'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 filtrent tout. Ne cherchez pas une courbe avant de savoir si cela anime ou non.
- 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 cela semble familier. - Étendez les tokens de la base de code, ne les forkez pas. Si
--ease-out-softou un token de durée existe déjà danspackages/ui/styles/globals.css, utilisez-le. Ajouter un système parallèle est un défaut. - Le mouvement réduit et le filtrage au survol sont livrés avec l'animation, pas en tant que correctif ultérieur.
- L'outil le moins cher qui fonctionne. N'installez pas une bibliothèque de mouvement pour un fondu.
La séquence de construction
1. Cela devrait-il animer ?
| Fréquence | Décision |
|---|---|
| 100+ fois/jour (raccourcis clavier, bascule de palette de commandes) | Jamais d'animation. Arrêtez ici. |
| Des dizaines de fois/jour (effets de survol, navigation dans les listes) | Quasi-imperceptible uniquement — rapide et subtil, ou rien |
| Occasionnel (modales, tiroirs, toasts) | Animation standard |
| Rare / première fois (intégration, succès, célébration) | Le budget de délice vit ici |
Les actions initiées par le clavier sont un disqualifiant, pas un jugement à prendre. Raycast n'a pas d'animation d'ouverture/fermeture — c'est correct pour quelque chose d'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 indice statique) à la place.
2. Quel est l'objectif ?
Nommez-le dans l'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 compréhensible
- Prévention d'un changement brusque — faire le pont entre des contenus qui se téléporteraient autrement
- Explication — démontrer comment quelque chose fonctionne (marketing/intégration uniquement)
- Délice — autorisé uniquement pour le niveau rare/première fois
Vous ne pouvez pas le nommer ? Ne le construisez pas. « C'est cool » sur un élément fréquemment vu 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 de suivi de souris décoratif appartient à une page marketing, pas à un graphique dans une application bancaire.
3. Choisissez l'outil — le moins cher 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éterminé qui doit rester fluide pendant que la page charge | Animation CSS (s'exécute hors du thread principal) |
| Contrôle programmatique avec performances CSS, sans bibliothèque | WAAPI (element.animate()) |
| Ressorts, animations de disposition, animations de sortie, valeurs pilotées par gestes | Motion (motion.dev) |
Les animations CSS battent JS sous charge — elles s'exécutent hors du thread principal, tandis que les animations basées sur requestAnimationFrame perdent des images pendant que le navigateur charge, exécute des scripts ou peint. Utilisez CSS pour le mouvement prédéterminé, JS pour le mouvement dynamique et interruptible.
Si la tâche nécessite un composant plutôt qu'une animation — un toast, un tiroir, un menu de commandes, une liste déroulante — réutilisez @asym/ui et Base UI. N'invoquez pas pick-ui-library sauf si l'utilisateur a explicitement demandé quelle bibliothèque utiliser. Faire ces choses à la main, c'est ainsi que vous vous retrouvez avec une liste déroulante <div> et aucune gestion de focus.
4. Choisissez les propriétés
transformetopacityuniquement. Ils sautent la mise en page et la peinture, et s'exécutent sur le GPU.width/height/margin/padding/top/leftdéclenchent les trois. (clip-pathest le quatrième sanctionné — voir RECIPES.md.heightest toléré uniquement pour les accordéons, où il n'y a pas d'équivalent transform.)- Jamais
scale(0). Partez descale(0.9–0.97)+opacity: 0. Rien dans le monde réel n'apparaît de rien. transform-originau déclencheur pour les popovers, listes déroulantes, 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 de l'élément lui-même —translateY(100%)se déplace de sa propre hauteur quel que soit le contenu. Privilégiez-les par rapport aux pixels codés en dur. - Dans Motion,
x,y, etscalesont des transformations indépendantes prises en charge. Ils sont performants. Utilisez une chaînetransformcomplète uniquement lorsque l'animation doit rester sur le compositeur pendant que le thread principal est occupé :
<motion.div animate={{ x: 100 }} />
<motion.div animate={{ transform: "translateX(100px)" }} />
- Ne pilotez jamais la transformation d'un enfant à partir d'une variable CSS sur le parent — cela recalcule les styles pour chaque enfant. Définissez
transformdirectement sur l'élément.
5. Assouplissement et durée — ou un ressort
Assouplissement, dans l'ordre de décision :
| Situation | Assouplissement |
|---|---|
| Entrée ou sortie | ease-out |
| Déplacement / transformation à l'écran | ease-in-out |
| Survol / changement de couleur | ease |
| Mouvement constant (marquise, progression) | linear |
| Par défaut | ease-out |
Jamais ease-in sur l'interface utilisateur. Il commence lentement, retardant le moment exact que l'utilisateur regarde. ease-out à 200ms semble plus rapide que ease-in à 200ms.
Les assouplissements CSS intégrés sont trop faibles. Utilisez ceux-ci :
--ease-out-soft: cubic-bezier(
0.22,
1,
0.36,
1
); /* Token Core; assouplissement fort pour l'interface */
--ease-in-out-soft: cubic-bezier(
0.77,
0,
0.175,
1
); /* assouplissement fort pour le mouvement à l'écran */
--ease-drawer: cubic-bezier(
0.32,
0.72,
0,
1
); /* Courbe de tiroir à la iOS (Ionic) */
Besoin d'une courbe qui n'est pas ici ? Prenez-la sur easing.dev ou easings.co. Ne la fabriquez pas à la main.
Durée :
| Élément | Durée |
|---|---|
| Retour de pression de bouton | var(--duration-press) (120ms) |
| Infobulles, petits popovers | var(--duration-micro) (150ms) |
| Listes déroulantes, sélecteurs | var(--duration-standard) (220ms) |
| Modales | var(--duration-modal) (220ms) |
| Tiroirs | var(--duration-drawer) (320ms) |
| Marketing / explicatif | Peut être plus long |
Les animations d'interface restent en dessous de 300ms. Une liste déroulante de 180ms semble plus réactive qu'une de 400ms.
Utilisez un ressort à la place lorsque le mouvement est un glissement avec inertie, 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 rejeter 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 reciblent à 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 depuis le bas part par le bas. Les chemins symétriques sont ce qui rend le glissement pour rejeter évident.
- Temporisation asymétrique là où l'utilisateur décide. Lent sur la phase délibérée (une pression maintenir pour confirmer : 2s linéaire), rapide sur la réponse système (relâchement : 200ms ease-out).
7. Mouvement réduit et filtrage du pointeur
Livré avec l'animation, à chaque fois.
@media (prefers-reduced-motion: reduce) {
.element {
animation: fade 0.2s ease;
} /* gardez opacity/color, supprimez le mouvement basé sur transform */
}
@media (hover: hover) and (pointer: fine) {
.element:hover {
transform: scale(1.05);
} /* le tactile déclenche de faux survols au toucher */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : "-100%";
Le mouvement réduit signifie moins et plus douces animations, pas zéro — gardez les transitions qui aident à la compréhension, supprimez les changements de mouvement et de position.
Recettes
Pour des implémentations prêtes à construire des cas courants — pression de bouton, liste déroulante, infobulle, modale, tiroir, toast, accordéon, décalage, maintenir pour confirmer, indicateur d'onglet, défilement révélé, glisser pour rejeter — voir RECIPES.md. Chargez-le chaque fois 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. Chacun de ces éléments est un blocage automatique dans review-animations :
| Jamais | Plutôt |
|---|---|
transition: all | Nommez les propriétés exactes |
transform: scale(0) 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 | Pas d'animation |
| Durée d'interface au-dessus de 300ms sans raison | 150–250ms |
transform-origin: center sur un popover ancré au déclencheur | var(--transform-origin) (modales exemptées) |
| Keyframes sur des toasts, bascules, éléments déclenchés rapidement | Transitions CSS |
Animer width/height/margin/padding/top/left | transform / opacity |
Props 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 entrer en même temps | Décalage de 30–80ms |
Résultat
Écrivez le code. Ensuite, en quelques lignes maximum :
- Le résultat de la porte — niveau de fréquence et objectif 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, en une ligne chacun.
- Que vérifier manuellement — 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 entrante), dites-le et pointez vers la vérification : jouez-le à 2–5× la durée ou dans l'inspecteur d'animations DevTools, parcourez-le image par image, testez les gestes sur un vrai appareil, et regardez à nouveau le