Motion UI
Un playbook fondé sur la recherche pour l'animation et les gestes dans l'interface produit : 19 fichiers de patterns, chacun avec des règles, des anti-patterns, des références bonnes et mauvaises, des considérations d'accessibilité, des tokens, une esquisse d'implémentation et une checklist. Ce fichier donne le workflow, les non-négociables, les tables de décision et les valeurs par défaut des tokens. Ouvrez les fichiers de patterns pour plus de détails.
- Index des patterns :
references/INDEX.mdliste chaque pattern avec sa règle en une ligne. - Fichiers de patterns :
references/patterns/<préfixe>-<nom>.md. Les préfixes sontmfound(but, timing, chorégraphie, mouvement réduit),mspring(ressorts),mgesture(glisser, momentum, bords, feuilles, interruption),mtrans(entrée/sortie, origine spatiale, transitions de route, micro-interactions, piloté par le défilement),mperf(performance) etmref(grille d'évaluation, anti-patterns). - Tokens de démarrage :
assets/motion-tokens.css. Les noms et valeurs de durée, d'assouplissement et de décalage correspondent à ceux detokens.cssde dashboard-ui. Il fonctionne seul en mode clair et sombre : les tokens de rôle dashboard-ui qu'il lit sont déclarés avec une spécificité nulle, donctokens.cssde dashboard-ui ou les tokens propres du projet sur les mêmes noms de rôle les remplacent quel que soit l'ordre de chargement. - Data UIs : pour les interpolations numériques, les transitions de graphiques, l'exploration liée, le recalcul en direct et les états de chargement, utilisez les patterns
motion-*etprog-*de dashboard-ui. Cette compétence ne les répète pas.
Workflow
- Décidez s'il doit y avoir du mouvement. Nommez le travail : feedback, continuité, orientation, attention ou (rarement) plaisir. Estimez la fréquence et si le déclencheur est un clavier, puis choisissez la ligne dans le tableau de fréquence ci-dessous (
mfound-purpose-and-frequency.md). S'il n'y a pas de travail, ou si l'action est déclenchée par clavier ou se produit 100 fois par jour ou plus, arrêtez : pas d'animation. - Choisissez le mécanisme.
- Repos-à-repos et bascule (menus, boîtes de dialogue, bascules) : une transition CSS (
mfound-durations-and-easing.md), ou un tokenlinear()de ressort (mspring-css-linear-and-tokens.md). - Piloté par un doigt ou un pointeur, ou interruptible avec vélocité : un ressort JavaScript (
mspring-parameters-and-mapping.md,mgesture-interruptibility-and-velocity.md). - Navigation : View Transitions (
mtrans-view-transitions-and-routes.md). - Lié à la position de défilement : animation pilotée par le défilement (
mtrans-scroll-driven-animations.md).
- Repos-à-repos et bascule (menus, boîtes de dialogue, bascules) : une transition CSS (
- Définissez le timing à partir des tokens. Durée par élément, assouplissement par direction, sorties à 0,75× l'entrée, et ressorts comme durée plus rebond. N'utilisez jamais de valeurs brutes dans les composants.
- Placez-le dans l'espace. Utilisez
transform-originau point de déclenchement, reflétez les sorties, gardez l'avant et l'arrière cohérents, et laissez le chrome persistant immobile (mtrans-spatial-origin-and-continuity.md). Pour l'entrée/sortie des éléments de la couche supérieure, suivezmtrans-enter-exit-top-layer.md. - Pour les gestes, appliquez dans l'ordre :
- Suivi 1:1 avec un seuil de 10 px (
mgesture-direct-manipulation-drag.md) ; - Projection et vélocité lors du relâchement (
mgesture-momentum-projection-and-snap.md) ; - Bords élastiques (
mgesture-rubber-banding-and-bounds.md) ; - Règles pour les feuilles et les balayages (
mgesture-sheets-and-swipe-to-dismiss.md).
- Suivi 1:1 avec un seuil de 10 px (
- Chorégraphiez lorsque plusieurs choses changent : cause d'abord, puis parent, puis enfants ; décalage de 20 à 40 ms, plafonné (
mfound-choreography-and-stagger.md). - Rendez-le peu coûteux. Animez uniquement
transformetopacity, n'utilisez pas dewill-changeglobal, et peignez le feedback dans l'image suivante (mperf-compositor-will-change-and-inp.md). - Écrivez la version à mouvement réduit comme des substitutions, pas des suppressions (
mfound-reduced-motion-vestibular.md). - Analysez à partir d'images.
- Passez en revue les anti-patterns (
mref-anti-patterns-gallery.md). - Capturez des séquences d'images (ralenties 4×, mouvement complet et réduit, plus une exécution interrompue) et l'audit intégré à la page.
- Notez la grille d'évaluation en 18 points (
mref-motion-review-rubric.md). Livrez à 80% ou plus, avec aucun must-check à 0. - Rapportez chaque constat comme ID de vérification · preuve · correctif, ainsi que ce que vous n'avez pas vérifié.
- Passez en revue les anti-patterns (
Non-négociables
Ne brisez l'un d'eux qu'avec une raison écrite.
S'il faut animer et combien de temps
- Chaque animation a un travail nommé. Les actions déclenchées par clavier et les actions à 100+/jour n'ont pas d'animation.
- La première réponse visuelle arrive dans les 100 ms suivant l'entrée, quelle que soit la durée de l'animation.
- Les durées proviennent des tokens (100 / 150 / 240 / 400 ms). Rien dans le chrome de l'interface ne dépasse 400 ms ; seuls les moments rares peuvent atteindre 600 ms.
- Les entrées sont en ease-out ; les mouvements à l'écran en ease-in-out ; pas de
ease-insur ce que l'utilisateur attend. Les sorties sont à environ 0,75× l'entrée.
Ressorts et gestes
- Les ressorts sont écrits comme durée + rebond. Utilisez rebond 0 pour le chrome de l'interface, 0,1–0,2 seulement après un geste avec momentum, et jamais sur l'opacité, la couleur ou les valeurs de données.
- Les éléments glissés suivent le pointeur 1:1 depuis le point de saisie, sans transition pendant le glissement. Engagez un glissement après environ 10 px.
- Au relâchement, accrochez à la cible la plus proche de la position projetée, et démarrez le ressort de stabilisation à la vélocité de relâchement.
- Les bords sont élastiques ; rien ne s'arrête brusquement sous le doigt.
- Tout ce que l'utilisateur peut affecter est interruptible à partir de sa valeur actuelle à l'écran. Il n'y a pas de files d'attente d'animation ni d'entrée bloquée pendant le mouvement. Les interfaces à bascule utilisent des transitions, pas des keyframes.
- Les gestes destructeurs s'engagent au relâchement et offrent une annulation. Chaque geste a un équivalent bouton ou clavier (WCAG 2.5.7).
Entrée, sortie et navigation
- Ne commencez jamais par
scale(0). Entrez depuis l'opacité 0 plus une échelle 0,95–0,97 ou 8–24 px de déplacement, avectransform-originau déclencheur. - Utilisez
@starting-stylepour l'entrée, etdisplay/overlayavecallow-discretepour la sortie. L'état final visible est la valeur par défaut, donc les navigateurs non supportés fonctionnent quand même. - Les transitions de route sont une amélioration progressive. Préparez les données d'abord, puis transitionnez. Utilisez le cross-fade par défaut ou un déplacement directionnel de 16–24 px par type de transition, nommez 1–3 éléments partagés, et déplacez le focus ensuite.
- Les toasts ne contiennent jamais la seule copie de l'information. Les erreurs ne se ferment jamais automatiquement ; un toast d'annulation reste au moins 8 s et son action existe aussi en dehors du toast. Les minuteurs se mettent en pause au survol, au focus et dans les onglets cachés (
comp-notifications-alerts.mdde dashboard-ui).
Performance et sécurité
- Animez uniquement les propriétés de type transform et l'opacité sur tout élément plus grand qu'un petit contrôle. Pas de
transition: all.will-changeest temporaire et suit une mesure. - Sous
prefers-reduced-motion: reduce, remplacez le mouvement spatial par un fondu de 150 ms ou moins, gardez le feedback, gardez le suivi de glissement 1:1, et supprimez le rebond. N'envoyez jamais un interrupteur global0.01ms, et l'animation JS doit aussi respecter ce paramètre. - Pas de parallaxe, de détournement de défilement, de zoom plein écran ou d'animation en boucle inactive dans l'interface produit. Les contenus en lecture automatique de plus de 5 s ont un contrôle de pause, et rien ne clignote plus de 3 fois par seconde.
- Analysez l'animation à partir d'images capturées, pas à partir du code ou de la mémoire.
Tables de décision
Fréquence → animation (mfound-purpose-and-frequency.md)
| Fréquence | Animation |
|---|---|
| Déclenché par clavier, ou 100+ fois par jour (limite de la compétence) | Aucune |
| Des dizaines de fois par jour | 100–150 ms de fondu, peut-être une petite échelle ; pas de mouvement, pas de rebond |
| Quelques fois par session | 150–240 ms, peut se déplacer de 8–24 px |
| Rare (première exécution, grand succès) | Jusqu'à 400–600 ms, un ressort avec rebond autorisé |
Mécanisme (mspring-parameters-and-mapping.md, mspring-css-linear-and-tokens.md)
| Situation | Utiliser |
|---|---|
| Couleur, opacité, changement d'état | Transition CSS, linear ou ease-out |
| Élément à bascule pouvant être inversé à mi-parcours | Transition CSS (jamais de keyframes) |
| Mouvement spatial repos-à-repos avec effet de ressort | Token CSS linear() de ressort plus sa propre durée |
| Relâchement après glissement ou projection, ou reciblage avec vélocité | Ressort JS (Motion, React Spring, SwiftUI, Compose) |
| Changement de mise en page (réordonnancement, redimensionnement, expansion) | FLIP, Motion layout, ou une View Transition |
| Changement de page ou de route | View Transition (même document ou document croisé) |
| Progression dans un défileur | Animation pilotée par le défilement |
Durée et assouplissement par élément (mfound-durations-and-easing.md)
| Élément | Durée | Courbe |
|---|---|---|
| Pression, bascule, survol | 100 ms | ease-out (pression échelle 0.97) |
| Infobulle, menu, popover | 150 ms entrée / 110 ms sortie | ease-out entrée, ease-in ou fondu sortie |
| Boîte de dialogue, toast | 240 ms entrée / 180 ms sortie | ease-out entrée, ease-in ou fondu sortie |
| Feuille, tiroir | 240–400 ms | --motion-ease-drawer, ou un ressort après glissement |
| Transformation de conteneur (carte → détail) | 400 ms | accentué |
| Cross-fade de route | 150–250 ms | linear |
Préréglages de ressorts (mspring-parameters-and-mapping.md)
| Token | Durée / rebond | Utilisation |
|---|---|---|
spring-fast | 0.24 s / 0 | bascules, petits contrôles |
spring-default | 0.3 s / 0 | menus, stabilisation de feuille, mise en page |
spring-slow | 0.45 s / 0 | surfaces plein écran |
spring-snappy | 0.3 s / 0.15 | relâchement après un mouvement rapide, accrochages |
spring-playful | 0.4 s / 0.3 | plaisir rare uniquement |
Les paramètres de bibliothèque (Motion, React Spring, SwiftUI, Material 3) proviennent d'une formule dans mspring-parameters-and-mapping.md.
Seuils de gestes (mgesture-*)
| Valeur | Par défaut |
|---|---|
| Début de glissement / verrouillage d'axe | 10 px |
| Fenêtre d'échantillonnage de vélocité | 100 ms |
| Décélération de projection | 0.998 par ms (0.99 pour le défilement rapide) |
| Engagement de mouvement rapide | > 400 px/s |
| Fermeture de feuille | > 25% de sa hauteur glissée, ou un mouvement rapide |
| Constante d'élasticité | 0.55 (approximation courante) |
Valeurs par défaut des tokens
Ensemble complet dans assets/motion-tokens.css.
| Groupe | Valeurs par défaut |
|---|---|
| Durée | instant 0 · micro 100 · court 150 · moyen 240 · long 400 ms · ratio de sortie 0.75 |
| Assouplissement | standard cubic-bezier(0.2,0,0.38,0.9) · entrée (0,0,0.38,0.9) · sortie (0.2,0,1,0.9) · accentué (0.2,0,0,1) · tiroir (0.32,0.72,0,1) |
| Ressorts (CSS) | --motion-spring-{fast,default,slow,snappy,playful} avec -dur correspondant (360 / 450 / 670 / 420 / 660 ms) |
| Géométrie | échelle de 0.96 · pression 0.97 · distance 8 / 16 / 24 px |
| Chorégraphie | décalage 30 ms · max 300 ms (150 ms dans les menus) |
| Mouvement réduit | tokens spatiaux réduits à 0 ou 1 ; les fondus conservent leur timing |
Comment appliquer cette compétence
- En construction :
- Chargez
assets/motion-tokens.css, ou mappez-le sur les tokens du projet. - Privilégiez les fonctionnalités de la plateforme : transitions CSS,
@starting-style,<dialog>et l'API popover, View Transitions, animations pilotées par le défilement,linear(). Recourez à une bibliothèque JS uniquement pour les gestes et la vélocité. - N'utilisez jamais le type TypeScript
any.
- Chargez
- En révision : capturez d'abord les images, puis parcourez la galerie d'anti-patterns et la grille d'évaluation. Rapportez un tableau de vérification, score, preuve et correctif, classé par sévérité, et listez ce que vous n'avez pas vérifié.
- Lorsque le projet a un système de motion (M3, Carbon, ses propres tokens) : ses tokens gagnent. Mappez-les sur ces rôles et signalez les lacunes.
- En cas de conflit de règles : l'accessibilité et le contrôle de l'utilisateur (mouvement réduit, interruptibilité, pas de détournement de défilement) priment sur l'expressivité, et la fréquence prime sur le plaisir.