Que fait Motion (Framer Motion) — Compétence ?
Nom : motion
Objectif : Implémenter des animations fluides et accessibles avec motion/react dans React.
Utilisez cette compétence pour ajouter des animations, des gestes ou des transitions de mise en page.
À utiliser lorsque : Vous utilisez motion/react (motion, AnimatePresence, useScroll, etc.).
Ne pas utiliser lorsque : Aucune animation n'est nécessaire ou le composant est strictement rendu côté serveur.
Règles
- Limite client uniquement : Motion nécessite
'use client'; conservez des îlots clients petits. - Commencez simple : Débutez par l'opacité/translation avant d'ajouter la physique des ressorts.
- Utilisez le bon outil :
AnimatePresencepour les entrées/sorties,layoutpour la mise en page,whileHover/whileTappour les gestes. - Respectez le mouvement réduit : Utilisez
useReducedMotion(). - Discipline de bundle : Utilisez
LazyMotionpour les grandes surfaces d'animation.
Flux de travail
- Identifiez l'objectif UX (retour, transition, focus).
- Ajoutez la plus petite limite
'use client'. - Implémentez correctement les transitions d'entrée/sortie ou de mise en page.
- Respectez les préférences de mouvement réduit.
- Vérifiez les performances et la taille du bundle.
Listes de contrôle
Liste de contrôle d'implémentation
-
'use client'seulement là où c'est nécessaire - Comportement de mouvement réduit défini
-
AnimatePresenceencapsule l'interface conditionnelle - Les transitions de mise en page utilisent
layout
Liste de contrôle de révision
- Les animations ne se relancent pas à chaque rendu
- Le code Motion n'étend pas inutilement l'arbre client
Exemples minimaux
Entrée/Sortie
"use client";
import { AnimatePresence, motion } from "motion/react";
export function Toast({
open,
children,
}: {
open: boolean;
children: React.ReactNode;
}) {
return (
<AnimatePresence>
{open ? (
<motion.div
initial={{ opacity: 0, y: 8 }}
animate={{ opacity: 1, y: 0 }}
exit={{ opacity: 0, y: 8 }}
transition={{ duration: 0.18 }}
>
{children}
</motion.div>
) : null}
</AnimatePresence>
);
}
Animation de mise en page
"use client";
import { motion } from "motion/react";
export function Expander({ open }: { open: boolean }) {
return (
<motion.div layout className="overflow-hidden rounded-md border p-3">
<div className="font-medium">Titre</div>
{open ? <div className="mt-2 text-sm">Plus de contenu...</div> : null}
</motion.div>
);
}
Mouvement réduit
"use client";
import { motion, useReducedMotion } from "motion/react";
export function FadeIn({ children }: { children: React.ReactNode }) {
const reduce = useReducedMotion();
return (
<motion.div
initial={reduce ? false : { opacity: 0, y: 6 }}
animate={reduce ? { opacity: 1 } : { opacity: 1, y: 0 }}
transition={{ duration: 0.2 }}
>
{children}
</motion.div>
);
}
Erreurs et pièges courants
- Démontage sans
AnimatePresence(les animations de sortie ne se déclenchent jamais) - Animation de mise en page sans
layout - Placer Motion dans un énorme arbre client
- Animer de grandes listes sans virtualisation