Communitygithub.com

motion-ui

Montre à un agent comment planifier, construire ou découper une interface utilisateur animée (« motion UI ») afin que le résultat concret soit une passe de design system avec des tokens. La procédure parcourt Motion UI, Workflow, Non-negotiables. À utiliser lorsqu'une nouvelle mission requiert ce savoir-faire.

Qu'est-ce que motion-ui ?

Motion UI est un playbook de recherche dédié à la conception et à la mise en œuvre d'animations et de gestes dans les interfaces produit. Il fournit 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. Le playbook guide l'agent à travers un workflow en neuf étapes, des non-négociables stricts, des tables de décision et des valeurs par défaut de tokens. Il couvre les mécanismes d'animation (transitions CSS, ressorts JavaScript, View Transitions, animations pilotées par le défilement), la gestion des gestes (glisser, momentum, élastique, feuilles), la chorégraphie, la performance et la réduction de mouvement. L'analyse est effectuée à partir de captures d'écran ralenties et d'une grille d'évaluation de 18 points. L'outil est conçu pour les agents travaillant avec Claude Code, Cursor, Codex et autres IDE/agents qui ont besoin de produire un motion design cohérent, accessible et performant. Les règles prioritaires sont l'accessibilité et le contrôle utilisateur avant l'expressivité, et la fréquence d'utilisation avant le plaisir esthétique.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehudaBriskman/fUdesIgn/tree/HEAD/plugins/motion-ui/skills/motion-ui

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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.md liste chaque pattern avec sa règle en une ligne.
  • Fichiers de patterns : references/patterns/<préfixe>-<nom>.md. Les préfixes sont mfound (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) et mref (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 de tokens.css de 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, donc tokens.css de 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-* et prog-* de dashboard-ui. Cette compétence ne les répète pas.

Workflow

  1. 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.
  2. Choisissez le mécanisme.
    • Repos-à-repos et bascule (menus, boîtes de dialogue, bascules) : une transition CSS (mfound-durations-and-easing.md), ou un token linear() 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).
  3. 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.
  4. Placez-le dans l'espace. Utilisez transform-origin au 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, suivez mtrans-enter-exit-top-layer.md.
  5. 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).
  6. 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).
  7. Rendez-le peu coûteux. Animez uniquement transform et opacity, n'utilisez pas de will-change global, et peignez le feedback dans l'image suivante (mperf-compositor-will-change-and-inp.md).
  8. Écrivez la version à mouvement réduit comme des substitutions, pas des suppressions (mfound-reduced-motion-vestibular.md).
  9. 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é.

Non-négociables

Ne brisez l'un d'eux qu'avec une raison écrite.

S'il faut animer et combien de temps

  1. Chaque animation a un travail nommé. Les actions déclenchées par clavier et les actions à 100+/jour n'ont pas d'animation.
  2. La première réponse visuelle arrive dans les 100 ms suivant l'entrée, quelle que soit la durée de l'animation.
  3. 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.
  4. Les entrées sont en ease-out ; les mouvements à l'écran en ease-in-out ; pas de ease-in sur ce que l'utilisateur attend. Les sorties sont à environ 0,75× l'entrée.

Ressorts et gestes

  1. 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.
  2. 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.
  3. 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.
  4. Les bords sont élastiques ; rien ne s'arrête brusquement sous le doigt.
  5. 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.
  6. 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

  1. 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, avec transform-origin au déclencheur.
  2. Utilisez @starting-style pour l'entrée, et display/overlay avec allow-discrete pour la sortie. L'état final visible est la valeur par défaut, donc les navigateurs non supportés fonctionnent quand même.
  3. 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.
  4. 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.md de dashboard-ui).

Performance et sécurité

  1. 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-change est temporaire et suit une mesure.
  2. 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 global 0.01ms, et l'animation JS doit aussi respecter ce paramètre.
  3. 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.
  4. 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équenceAnimation
Déclenché par clavier, ou 100+ fois par jour (limite de la compétence)Aucune
Des dizaines de fois par jour100–150 ms de fondu, peut-être une petite échelle ; pas de mouvement, pas de rebond
Quelques fois par session150–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)

SituationUtiliser
Couleur, opacité, changement d'étatTransition CSS, linear ou ease-out
Élément à bascule pouvant être inversé à mi-parcoursTransition CSS (jamais de keyframes)
Mouvement spatial repos-à-repos avec effet de ressortToken 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 routeView Transition (même document ou document croisé)
Progression dans un défileurAnimation pilotée par le défilement

Durée et assouplissement par élément (mfound-durations-and-easing.md)

ÉlémentDuréeCourbe
Pression, bascule, survol100 msease-out (pression échelle 0.97)
Infobulle, menu, popover150 ms entrée / 110 ms sortieease-out entrée, ease-in ou fondu sortie
Boîte de dialogue, toast240 ms entrée / 180 ms sortieease-out entrée, ease-in ou fondu sortie
Feuille, tiroir240–400 ms--motion-ease-drawer, ou un ressort après glissement
Transformation de conteneur (carte → détail)400 msaccentué
Cross-fade de route150–250 mslinear

Préréglages de ressorts (mspring-parameters-and-mapping.md)

TokenDurée / rebondUtilisation
spring-fast0.24 s / 0bascules, petits contrôles
spring-default0.3 s / 0menus, stabilisation de feuille, mise en page
spring-slow0.45 s / 0surfaces plein écran
spring-snappy0.3 s / 0.15relâchement après un mouvement rapide, accrochages
spring-playful0.4 s / 0.3plaisir 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-*)

ValeurPar défaut
Début de glissement / verrouillage d'axe10 px
Fenêtre d'échantillonnage de vélocité100 ms
Décélération de projection0.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.

GroupeValeurs par défaut
Duréeinstant 0 · micro 100 · court 150 · moyen 240 · long 400 ms · ratio de sortie 0.75
Assouplissementstandard 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égraphiedécalage 30 ms · max 300 ms (150 ms dans les menus)
Mouvement réduittokens 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.
  • 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.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés