Implémentation d'animations avec Motion
Utilisez la bibliothèque Motion (https://motion.dev) pour tout travail d'animation.
Démarrage rapide
React (Principal) :
import { motion } from "motion/react"
// Animation de base
<motion.div animate={{ opacity: 1, y: 0 }} />
// Avec configuration de transition
<motion.div
animate={{ x: 100 }}
transition={{ type: "spring", stiffness: 100 }}
/>
Modèles principaux
1. Physique du ressort (recommandé)
<motion.div
animate={{ scale: 1 }}
transition={{
type: 'spring',
stiffness: 260,
damping: 20,
}}
/>
Préréglages de ressort :
- Douce :
stiffness: 120, damping: 14 - Oscillante :
stiffness: 180, damping: 12 - Rigide :
stiffness: 300, damping: 20
2. Interactions gestuelles
<motion.div
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
drag="x"
dragConstraints={{ left: -100, right: 100 }}
/>
3. Animations de mise en page
<motion.div layout>{/* Contenu qui change de position/taille */}</motion.div>
4. Effets liés au défilement
import { useScroll, useTransform } from "motion/react"
const { scrollYProgress } = useScroll()
const opacity = useTransform(scrollYProgress, [0, 1], [1, 0])
<motion.div style={{ opacity }} />
5. Animation en cascade des enfants
<motion.ul
variants={{
visible: { transition: { staggerChildren: 0.07 } },
}}
>
{items.map((item) => (
<motion.li
key={item}
variants={{
hidden: { opacity: 0, y: 20 },
visible: { opacity: 1, y: 0 },
}}
/>
))}
</motion.ul>
6. Animations d'entrée/sortie
import { AnimatePresence } from 'motion/react';
<AnimatePresence>
{show && <motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} exit={{ opacity: 0 }} />}
</AnimatePresence>;
Propriétés d'animation
Transformations (accélérées par GPU, performantes) :
x, y, z- Translationscale, scaleX, scaleY- Échellerotate, rotateX, rotateY, rotateZ- Rotationskew, skewX, skewY- Inclinaison
Visuelles (à utiliser avec parcimonie, peuvent affecter les performances) :
opacitybackground, backgroundColorcolorborderRadius
Spécifiques SVG :
pathLength- Pour les animations de tracépathOffset- Décaler le tracépathSpacing- Espacement entre les tirets
Accessibilité
Respectez toujours les préférences utilisateur :
<motion.div
animate={{ x: 100 }}
transition={{
type: 'spring',
// Désactive l'animation si l'utilisateur préfère une réduction de mouvement
duration: 0,
}}
/>
Motion gère automatiquement prefers-reduced-motion. Les ressorts deviennent des transitions instantanées.
Conseils de performance
- Animez uniquement les transformations/l'opacité dans la mesure du possible (accéléré par GPU)
- Utilisez la propriété
layoutplutôt que d'animer manuellement la largeur/hauteur - Évitez d'animer pendant le défilement lorsque c'est possible
- Utilisez
will-change: transformpour les animations complexes (Motion le gère) - Limitez les animations simultanées - utilisez l'effet cascade plutôt que tout en même temps
Principes de conception (bref)
Quand animer
- Transitions d'état (chargement → succès)
- Changements spatiaux (entrée/sortie de vue)
- Attirer l'attention (avec parcimonie)
- Confirmer une action utilisateur
Quand NE PAS animer
- Actions répétées après la première occurrence
- Chemins critiques pour les performances
- Défilement contrôlé par l'utilisateur
- Chaque interaction (la retenue compte)
Directives de temporisation
- Micro-interactions : 150-250ms
- Transitions de panneaux/modales : 200-300ms
- Transitions de page : 300-500ms
- Ressorts : Laissez la physique déterminer la durée
Ressort vs Durée
- Utilisez les ressorts pour : Éléments interactifs, gestes, changements de mise en page
- Utilisez la durée pour : Séquences intentionnelles, chorégraphie, chargeurs
Consultez principles.md pour la philosophie détaillée des animations.
Modèles courants
État de chargement :
<motion.div
animate={{ rotate: 360 }}
transition={{
repeat: Infinity,
duration: 1,
ease: 'linear',
}}
/>
Notification toast :
<motion.div
initial={{ x: 400, opacity: 0 }}
animate={{ x: 0, opacity: 1 }}
exit={{ x: 400, opacity: 0 }}
transition={{ type: 'spring', stiffness: 300, damping: 30 }}
/>
Tiroir :
<motion.div
initial={{ x: '-100%' }}
animate={{ x: 0 }}
exit={{ x: '-100%' }}
transition={{ type: 'spring', damping: 25 }}
/>
Accordéon :
<motion.div
animate={{ height: isOpen ? 'auto' : 0 }}
transition={{ type: 'spring', bounce: 0 }}
style={{ overflow: 'hidden' }}
/>
Ressources
- Documentation Motion : https://motion.dev/docs/react
- Exemples Motion : https://motion.dev/examples (100+ exemples gratuits)
- Dépôt GitHub : https://github.com/motiondivision/motion
- Ressources étendues : Consultez
resources.mdpour des leçons et une vault organisées sur animation.dev
Dépannage rapide
L'animation ne se lance pas ?
- Vérifiez si l'élément est rendu conditionnellement (utilisez AnimatePresence)
- Vérifiez que les valeurs cibles sont différentes des valeurs initiales
- Recherchez un éventuel CSS qui pourrait l'emporter (ex.
!important)
Problèmes de performance ?
- Limitez-vous aux transformations et à l'opacité
- Utilisez la propriété
layoutplutôt que d'animer les dimensions - Consultez l'onglet Performance des DevTools du navigateur
Clignotement des animations de mise en page ?
- Assurez-vous que le parent a
position: relative - Ajoutez
layoutau parent et à l'enfant si nécessaire - Vérifiez les transitions CSS conflictuelles
Notes
- Motion est sous licence MIT, prête pour la production
- Moteur hybride : 120fps, accéléré par GPU
- Support TypeScript intégré
- Tree-shakable pour une taille de bundle optimale
- Fonctionne avec React 18+ (y compris Suspense)