Patrons d'animation UI
Deux missions : animer une UI produit réelle sur le web, et reconstruire une UI produit pour une vidéo sans la redessiner. Les deux utilisent les mêmes jetons.
1. Jetons d'abord
Définissez le mouvement une fois et importez-le partout. Pas de nombres en ligne dans les composants.
// lib/motion-tokens.ts
export const motionTokens = {
duration: { instant: 0.1, fast: 0.18, normal: 0.3, slow: 0.5, scene: 0.7 },
easing: {
standard: [0.2, 0, 0, 1], // entrée + déplacement
exit: [0.4, 0, 1, 1], // sortie
emphasized: [0.3, 0, 0, 1],
},
distance: { nudge: 4, small: 8, medium: 16, large: 32 },
stagger: 0.06, // garder entre 0.05 et 0.10
} as const;
export const springs = {
press: { type: "spring", stiffness: 600, damping: 38 }, // boutons, bascules
snappy: { type: "spring", stiffness: 420, damping: 34 }, // chips, menus
gentle: { type: "spring", stiffness: 260, damping: 27 }, // cartes, panneaux
layout: { type: "spring", stiffness: 320, damping: 30 }, // réordonnancement, redimensionnement
camera: { type: "spring", stiffness: 140, damping: 20 }, // grands mouvements, vidéo uniquement
} as const;
Avec une masse de 1, le ratio d'amortissement ζ = damping / (2·√stiffness) : press 0.78, snappy 0.83, gentle 0.84, layout 0.84, camera 0.85 — tous dans la bande 0,75–0,90 (dépassement ≤ ~6 %). Ajustez par marque avec cette formule, et conservez ce tableau comme source unique.
2. Accessibilité et SSR
"use client";
import { useReducedMotion } from "motion/react";
export function useSafeMotion() {
const reduce = useReducedMotion();
return {
reduce,
// mouvement réduit : supprimer les transformations, garder les changements d'opacité courts (≤0.2 s)
enter: reduce ? { opacity: 1 } : { opacity: 1, y: 0 },
initial: reduce ? { opacity: 0 } : { opacity: 0, y: 8 },
transition: reduce ? { duration: 0.2 } : undefined,
};
}
- Utilisez
initial={false}pour les éléments déjà visibles au premier affichage afin d'éviter les flashs d'hydratation. - Animez uniquement
transformetopacity. N'animez jamaiswidth,height,top,leftoubox-shadowen boucle ; utilisezlayoutou scale à la place. - Appareils bas de gamme : raccourcissez les durées et ignorez les animations décoratives.
3. Patrons et leurs règles
| Patron | Règle |
|---|---|
| Pression de bouton | whileTap={{ scale: 0.96 }} avec springs.press ; retour dans les 100 ms |
| Rendu conditionnel | enveloppez dans AnimatePresence avec une key stable ; chaque initial + animate a une exit |
| Transition de page / route | AnimatePresence mode="wait" : la sortie se termine avant l'entrée |
| Stagger de liste | staggerChildren 0,05–0,10 s ; limitez les éléments en stagger à ~8, les autres apparaissent ensemble |
| Réordonnancement / redimensionnement | layout sur de petits sous-arbres uniquement (≲5 enfants) ; sinon x/y explicites |
| Modale / feuille | piège de focus, Échap ferme, verrouillage du défilement, role="dialog", aria-modal="true", retour du focus |
| Toast | entre depuis le bord où il se trouve ; l'auto-fermeture se met en pause au survol/focus |
| Changement de nombre | rouleau vertical : l'ancienne valeur sort vers le haut avec flou, la nouvelle entre par le bas ; font-variant-numeric: tabular-nums |
| Révélation au défilement | whileInView avec viewport={{ once: true }} ; ne jamais réanimer lors d'un défilement arrière |
| Chargement → succès | bouton se comprime → spinner → coche ; gardez la largeur du bouton stable |
4. Reconstruction d'UI produit pour vidéo
- Mesurez, ne devinez pas. Prenez les tokens de la source du produit ou des styles calculés : couleurs, rayons, famille de police/graisses/approche, espacement, icônes et stroke. Échantillonnez les couleurs à partir de captures d'écran réelles et comparez.
- Hybride par défaut. Capture d'écran réelle en contexte ; reconstruisez uniquement les éléments qui animent, pixel-alignés par-dessus.
- Ne redessinez jamais sans approbation explicite. Pas de nouvelles couleurs, polices, icônes ou texte.
- Capturez proprement. Compte déconnecté ou démo, données fictives, pas de données personnelles, pas de marques tierces sauf si l'utilisateur les possède.
- Consultable. Dans la vidéo, pilotez chaque valeur animée à partir du temps absolu (
value = f(t)), pas de l'état d'exécution demotion/react. Utilisezmotion/reactpour le web en direct, des ressorts en forme fermée ou des timelines GSAP pour la vidéo rendue.
Lorsque ces patrons sont utilisés sur un site web plutôt qu'une vidéo, exécutez la porte de vérification
design-expert (clavier, focus, mouvement réduit, performance) avant la mise en production.