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 basique
<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 à Ressort (Recommandée)
<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. Enfants en Décalage
<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 GPU, performantes) :
x, y, z- Translationscale, scaleX, scaleY- Échellerotate, rotateX, rotateY, rotateZ- Rotationskew, skewX, skewY- Inclinaison
Visuelles (À utiliser avec modération, peut affecter les performances) :
opacitybackground, backgroundColorcolorborderRadius
Spécifiques SVG :
pathLength- Pour les animations de tracépathOffset- Décalage du 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 moins de mouvement
duration: 0,
}}
/>
Motion gère automatiquement prefers-reduced-motion. Les ressorts deviennent des transitions instantanées.
Conseils de Performance
- Animer uniquement les transformations/opacité si possible (accéléré GPU)
- Utiliser la propriété
layoutau lieu d'animer manuellement la largeur/hauteur - Éviter d'animer pendant le défilement si possible
- Utiliser
will-change: transformpour les animations complexes (Motion s'en charge) - Limiter les animations simultanées - les décaler plutôt que toutes en même temps
Principes de Conception (Bref)
Quand Animer
- Transitions d'état (chargement → succès)
- Changements spatiaux (entrée/sortie de la 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 est importante)
Directives de Temporisation
- Micro-interactions : 150-250 ms
- Transitions de panneaux/modales : 200-300 ms
- Transitions de page : 300-500 ms
- Ressorts : Laissez la physique déterminer la durée
Ressort vs Durée
- Utiliser les ressorts pour : Éléments interactifs, gestes, changements de mise en page
- Utiliser la durée pour : Séquences intentionnelles, chorégraphie, chargeurs
Consultez principles.md pour une philosophie d'animation détaillée.
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
- Docs Motion : https://motion.dev/docs/react
- Exemples Motion : https://motion.dev/examples (plus de 100 exemples gratuits)
- Dépôt GitHub : https://github.com/motiondivision/motion
- Ressources supplémentaires : Consultez
resources.mdpour des leçons sélectionnées de animation.dev et un recueil
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
- Vérifiez la présence de CSS qui pourrait écraser (par exemple,
!important)
Problèmes de performances ?
- Limitez-vous aux transformations et à l'opacité
- Utilisez la propriété
layoutau lieu d'animer les dimensions - Vérifiez l'onglet Performances des outils de développement du navigateur
Scintillement 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êt pour la production
- Moteur hybride : 120 ips, accéléré GPU
- Support TypeScript intégré
- Tree-shakable pour une taille de bundle optimale
- Fonctionne avec React 18+ (y compris Suspense)