Implémenter le mouvement
Présentation
Cette compétence guide la traduction des animations et transitions Figma en code exécutable (motion.dev, images clés CSS, ou bibliothèques spécifiques au framework).
Figma expose le mouvement via deux outils :
get_motion_context— outil de mouvement autoritaire. Renvoie l'inventaire complet des nœuds animés, des extraits de code précalculés (CSS@keyframes+ motion.dev), des liaisons d'images clés de secours lorsque les extraits ne sont pas disponibles, et des indices de coordination de chronologie récursive (timelineCohorts). Source de vérité pour les données d'animation et les identifiants de nœuds qui animent.get_design_context— la structure du design : disposition, dimensions, ressources, style, indices Code Connect, contexte de capture d'écran, et parfois des marqueurs de placement de mouvement sur les éléments animés (data-node-id, et sur les nœuds divisésdata-motion-keys/data-motion-wrapper-for/data-motion-transform-template). Il peut rendre un nœud animé comme un élément simple (div,p,span, etc.) ou un élément de mouvement (motion.div) ; il n'intègre pas les valeurs d'animation.
Les deux sont liés par l'identifiant de nœud, et c'est tout le flux de travail. get_motion_context vous indique quels nœuds animent et donne les valeurs d'images clés, l'easing, le timing et les extraits. get_design_context vous indique à quoi ressemblent ces nœuds et où ils se trouvent. Pour chaque nœud dans get_motion_context.nodes, trouvez le data-node-id correspondant dans le contexte de design et fusionnez le mouvement dans cette structure — en ajoutant ou en enveloppant un motion.{tag} lorsque l'élément structurel est simple. Lorsque le contexte de design a réutilisé un composant Figma, le nœud de mouvement peut également inclure fallbackNodeId ; utilisez-le uniquement comme solution de secours après avoir essayé le nodeId exact.
Limites de la compétence
- Utilisez cette compétence lorsque le livrable est du code de mouvement dans le dépôt de l'utilisateur.
- Si l'utilisateur demande de créer/modifier des animations dans Figma lui-même, passez à figma-use et suivez cette compétence à la place.
- Cette compétence couvre actuellement les animations telles qu'émises par
get_motion_context(extraits plus pistes d'images clés de secours, y compris le mouvement provenant de préréglages résolu dans ces formes). Les flux de variantes interactives plus larges peuvent encore nécessiter une gestion d'état spécifique au produit dans le code.
Prérequis
- Serveur MCP Figma connecté et accessible.
- Identifiant de nœud extrait de l'URL Figma fournie par l'utilisateur. Format d'URL :
https://figma.com/design/:fileKey/:fileName?node-id=1-2— extrayezfileKey(le segment après/design/) etnodeId(la valeur du paramètre de requêtenode-id, par exemple42-15). - Base de code cible. Le format de sortie du mouvement s'adapte à la stack (voir Recommandations framework).
Choix de l'outil
Pour l'implémentation du mouvement, utilisez les deux outils avec des rôles distincts :
| Situation | Outil | Pourquoi |
|---|---|---|
| Comprendre la structure statique, les ressources, les styles, Code Connect ou la disposition visuelle | get_design_context | Donne la référence de code du composant/page et les URL des ressources nécessaires pour placer correctement les nœuds animés. |
| Récupérer les données d'animation pour n'importe quel nœud | get_motion_context | Conçu spécialement pour le mouvement et la source de vérité pour le timing, l'easing, les extraits et les images clés. |
Un nœud a des marqueurs de mouvement (data-motion-keys, data-motion-wrapper-for) | Marqueurs pour le placement divisé, get_motion_context pour les valeurs | Les marqueurs de division vous indiquent quelles pistes vont sur quel élément ; les images clés/easing/timing et l'inventaire des nœuds animés proviennent de get_motion_context. |
get_motion_context accepte recursive: true (limité à 500 nœuds) lorsque vous avez besoin du mouvement des descendants en un seul appel.
Flux de travail requis
Étape 1 : Confirmer la disponibilité du contexte de design statique
get_design_context(fileKey=":fileKey", nodeId="<node-id>")
Si get_design_context a déjà été appelé pour ce nœud, réutilisez cette sortie. Sinon, appelez-le normalement maintenant.
Utilisez-le comme la structure de référence — hiérarchie, dimensions, style, ressources, indices Code Connect, contexte de capture d'écran, et tous les marqueurs de placement de mouvement qu'il contient éventuellement (Étape 3). L'inventaire des nœuds animés et les valeurs d'animation proviennent de get_motion_context (Étape 2).
Étape 2 : Récupérer les données de mouvement autoritaires
get_motion_context(fileKey=":fileKey", nodeId="<node-id>", recursive=true)
Forme de la réponse (une entrée par nœud animé) :
codeSnippets— chaînes CSS@keyframeset motion.dev pré-générées. Utilisez-les directement. Ne les régénérez pas à partir des données de piste de secours.keyframeBindings— pistes d'images clés liées, y compris le mouvement dérivé de préréglages résolu en données de piste, incluses uniquement comme données de secours lorsque les deux formats d'extraits sont absents.motionSummary— description en langage naturel d'une ligne par champ de l'animation. Présent uniquement lorsqu'il n'y a pas d'extrait (le codegen de mouvement uniquement par liaisons d'images clés ne peut pas être exprimé en CSS/motion.dev). Construisez à partir de celui-ci lorsqu'il est présent ; ignorez-le chaque fois qu'un extrait existe.fallbackNodeId— identifiant de secours optionnel pour faire correspondre le contexte de design composantisé. SinodeIdest un identifiant qualifié d'instance tel queI4005:6111;30:8005, D2R peut rendre le corps du composant réutilisable avec l'identifiant du composant sous-jacent à la place, comme4002:3957. Dans ce cas,fallbackNodeIdest ledata-node-idà rechercher si la recherche exacte denodeIdéchoue.
Les réponses récursives incluent également timelineCohorts — un tableau de niveau supérieur (pas par nœud) de nœuds partageant une seule chronologie : { rootNodeId, durationMs, loopMode: 'once' | 'loop' | 'boomerang', memberNodeIds[] }. Pour un mouvement multi-nœuds coordonné, pilotez tous les memberNodeIds à partir d'un cycle de vie partagé en utilisant durationMs (÷1000 pour les secondes) et loopMode — n'inférez pas le timing à partir de l'ordre des frères.
Détails d'implémentation importants pour les LLM :
- Lorsqu'un extrait existe,
motionSummary,timelineDurationMsettransformOriginpeuvent être omis pour réduire la charge utile — l'extrait contient déjà la durée + l'origine de transformation (motion.devduration/style={{ transformOrigin }}, ou CSSanimation/transform-origin) et la cohorte contientdurationMs. Un champ manquant ne signifie jamais « pas d'animation ». - Les réponses récursives dédoublonnent les extraits identiques en double. Un extrait peut être remplacé par un commentaire pointant vers le premier nœud avec un mouvement identique ; réutilisez le même composant, variante, classe ou constantes au lieu d'écrire une seconde animation.
- Le serveur MCP déduit les extraits CSS vs motion.dev de
clientFrameworks; si la réponse ne contient qu'un seul format d'extrait, adaptez ce format à la stack de l'utilisateur plutôt que de supposer que l'autre format a échoué.
Étape 3 : Fusionner les contextes statique et de mouvement
- Commencez par
get_motion_context.nodes, et non par les balisesmotion.*visibles dans le JSX statique. Chaque nœud retourné est animé. Faites correspondre chaque nœud de mouvement auget_design_contextd'abord parnodeId/data-node-idexact. Si et seulement s'il n'y a pas de correspondance exacte, essayezfallbackNodeId/data-node-id. Revenez au nom/type de nœud et à la position de la capture d'écran uniquement après l'échec des deux identifiants. - La correspondance exacte d'identifiant l'emporte sur
fallbackNodeId.fallbackNodeIdpointe vers l'identifiant du composant sous-jacent que D2R peut émettre à l'intérieur d'un composant réutilisable. Il est partagé par chaque instance de ce composant. Si lenodeIdexact existe dans le contexte de design, appliquez le mouvement là-bas et ignorez la solution de secours. Ceci est crucial pour l'animation d'instance racine : une instance peut tourner ou se déplacer différemment d'une autre instance du même composant, et appliquer ce mouvement au corps du composant partagé animerait toutes les instances de manière incorrecte. - Appliquez chaque nœud de mouvement à la structure de contexte de design correspondante, indexée par
data-node-id. Ledata-node-idcorrespondant est l'ancre structurelle, pas toujours l'élément DOM final qui reçoit le mouvement. Utilisez la forme de l'extrait et les marqueurs de placement pour décider si le mouvement va sur cet élément exact, un emballage, un élément intérieur ou un chemin SVG en ligne.get_design_contextpeut déjà émettremotion.{tag}avec des valeurs supprimées, ou il peut émettre un élément structurel simple (div,p,span, racine de composant, etc.). S'il est simple et que l'extrait cible l'élément lui-même, convertissez-le enmotion.{tag}approprié ou ajoutez un emballage de mouvement tout en préservant le texte, les enfants, les classes/styles, les attributs et ledata-node-iddu nœud. Chargez references/examples-and-anti-examples.md pour voir des exemples de cette étape de fusion. - Le mouvement d'enfant composantisé correspond généralement par solution de secours. Lorsque le contexte de design extrait une instance Figma dans un composant React réutilisable, les enfants à l'intérieur de ce corps de composant ont souvent des identifiants de composant sous-jacents (
4002:3957) tandis que le contexte de mouvement signale des identifiants d'instance en direct (I4005:6111;30:8005). Dans ce cas, utilisezfallbackNodeIdpour trouver ledata-node-iddu corps du composant, mais gardez le mouvement limité à l'instance rendue que vous implémentez. S'il y a plusieurs instances et qu'une seule a un mouvement racine différent, la correspondance exacte d'identifiant maintient ce mouvement par instance séparé. - Les nœuds divisés portent un marqueur
data-motion-keys/data-motion-wrapper-for— voir Gestion des transformations entrelacées ci-dessous. - Préservez les emballages
display: contents— sauf si le groupe lui-même anime. Les emballages de groupe transparents en termes de disposition arrivent sous forme decontents(Tailwindcontents), généralement accompagnés d'unabsolute/inset-[…]mort (ceux-ci ne font rien sur une boîtecontents). Pour un groupe statique, gardezdisplay: contentset laissez les enfants se positionner par rapport au véritable ancêtre le plus proche — convertir leinsetde l'emballage en une boîte positionnée repositionne les enfants dans une boîte plus petite, donc ils s'affichent trop petits/décalés vers l'intérieur. Pour un groupe animé (le nœud du groupe lui-même a un mouvement),display: contentsne peut pas porter de transformation — remplacez-le par un véritable emballage positionné et appliquez le mouvement du groupe là-bas. Chargez references/gotchas.md avant d'implémenter ce cas. get_motion_contextest l'inventaire complet des nœuds animés. Certains nœuds animés s'affichent comme des éléments simples (nonmotion) — racines d'instance de composant (<div>de positionnement simple), texte (<p>), masques — qui portent toujours undata-node-id. Parcourez chaque nœud dans la réponse de mouvement et appliquez son mouvement à l'élément avec ledata-node-idcorrespondant, en enveloppant ou convertissant si nécessaire. Si un nœud animé n'a aucun élément du tout dans la sortie (par exemple, un masque animé aplati dans unmask-imagestatique), ne le supprimez pas silencieusement — laissez un commentaire// TODO: <nodeId> motion unsupportedet signalez-le dans votre résumé.- Si un nœud apparaît dans le contexte de mouvement mais pas dans le JSX statique, ajoutez l'élément nécessaire pour le représenter — le code du contexte de design est une référence, pas un inventaire d'animation complet.
- En cas de conflit entre le contexte de design et celui de mouvement (timing/easing/valeurs animées), préférez
get_motion_context. - Mouvement SVG au niveau du chemin : inlinez le SVG et animez le vrai
<path>. Lorsqueget_motion_contextcible le chemin d'un vecteur (PATH_TRIM,motion.path,stroke-dasharray) mais que le contexte de design le rend comme une<img>, inlinez le SVG et appliquez l'extrait au<path>, en gardant l'emballage de disposition. Chargez references/svg-and-path-motion.md pour le guide complet de ce cas (motion.path,pathLength="1", superposition emballage+chemin, découpage de chemin CSS).
Gestion des transformations entrelacées
Un nœud avec à la fois une transformation de base statique et des transformations animées est divisé en éléments imbriqués afin que les deux se composent correctement au lieu de se battre : un motion.div sans identifiant portant data-motion-wrapper-for="<nodeId>" (l'emballage EXTÉRIEUR) enveloppe une div de transformation statique (par exemple rotate-45 + dimensionnement hypot() — ou l'emballage lui-même porte data-motion-transform-template="<css>") qui enveloppe le nœud INTÉRIEUR (data-node-id). Gardez l'imbrication emballage > div transformation statique > intérieur — l'effondrer brise le dimensionnement et la transformation de base.
- Placez les pistes par
data-motion-keys. Lesdata-motion-keysde l'emballage (pistes de transformation —x/y/rotate/scaleX/scaleY/skewX) vont sur l'emballage EXTÉRIEUR ; lesdata-motion-keysde l'élément intérieur vont sur l'élément INTÉRIEUR. - Réappliquez un
data-motion-transform-template. Si l'emballage en porte un, définisseztransformTemplate={(_, generated) => "<css> " + generated}pour que la transformation animée se compose par-dessus cette transformation de disposition statique. - Décalez la transformation animée par la base statique (évitez la double rotation).
get_motion_contextdonne la transformation absolue du nœud, qui inclut déjà la base statique que ces divs appliquent. Un extraitrotatede[45, 125, 125]sur une baserotate-45signifie que l'emballage anime le décalage[0, 80, 80](= absolu − 45), pas l'absolu — sinon le 45° s'applique deux fois et l'élément se trouve à 90° au repos. Les pistes sans base statique (par exemplex/ycommençant à 0) passent inchangées. Voir l'exemple de transformation entrelacée. - Gardez les transformations de disposition séparées des transformations Motion. Pour chaque élément
motion.*qui animerotate,scaleouskew, vérifiez qu'il ne repose pas également sur des transformations de disposition Tailwind telles que-translate-x-1/2ou-translate-y-1/2pour le centrage/positionnement. Ces utilitaires partagent la propriété CSStransformque Motion.dev écrit en ligne, donc la transformation de Motion peut effacer la translation de disposition. Si les deux sont nécessaires, divisez l'élément en un emballage de disposition statique portant la transformation de centrage/positionnement et un élémentmotion.*intérieur portant rotate/scale/opacity animé, ou encodez le décalage de disposition dans Motion lui-même (x: "-50%") et gardez-le présent pour chaque image clé.
Étape 4 : Appliquer le mouvement dans le code
- motion.dev présent dans les extraits ? Utilisez le code motion.dev textuellement pour les cibles React. Importez depuis
motion/react— à moins que la base de code n'utilise déjà une autre bibliothèque de mouvement (Framer Motion, React Spring, GSAP), auquel cas adaptez l'extrait à celle-ci. Chargez references/framework-recommendations.md lors de l'adaptation à une autre stack ou du choix d'une bibliothèque. - Images clés CSS présentes ? Utilisez pour les cibles vanilla/non-React, ou lorsque la base de code n'a pas de bibliothèque de mouvement React.
- Pas d'extraits (uniquement liaisons d'images clés) ? Construisez l'équivalent motion.dev/CSS à partir de
keyframeBindings. Les propriétéskeyframeBindingsincluentnodeId,property(par exemplex,y,rotate,opacity,scaleX,scaleY,backgroundColor,borderRadius,fill,stroke,stroke-dashoffset,clip-path),keyframes(tableau de valeurs),easing(par exempleease,ease-in-out,[0.42,0,0.58,1],step-start, etc.), ettiming(durationMs,delayMs,endDelayMs,direction,iterations,fillMode). Convertissez ces données en syntaxe motion.dev ou CSS. Pour les images clés CSS, utilisez les fonctions d'easing et les valeurs de timing ; pour motion.dev, utilisez la durée, le délai, l'easing et le mode de boucle. Utilisez les extraits tels quels chaque fois qu'ils existent — leskeyframeBindingssont une solution de secours pour les animations que le générateur d'extraits n'a pas pu exprimer. - Pistes d'images clés manquantes ? Si
motionSummaryest présent, construisez le mouvement à partir du résumé en langage naturel. Lisez le résumé, déterminez le type d'animation (par exemple disparaître, se déplacer, pivoter), et créez une animation motion.dev ou CSS appropriée. Utilisez des valeurs d'images clés et de timing raisonnables basées sur la description. Ne générez un extrait à partir demotionSummaryque si les extraits et leskeyframeBindingssont tous absents. - Le mouvement qui disparaît ? Utilisez
animate={{ opacity: [1, 0] }}pour motion.dev ou@keyframes fadeOut { from { opacity: 1; } to { opacity: 0; } }pour CSS. UtilisezfillMode: 'forwards'si l'élément doit rester caché après l'animation. - Aucune des options ci-dessus ? Ne créez pas d'animation — laissez un commentaire expliquant le mouvement manquant.
Si la sortie de get_motion_context inclut un champ recommended_driver :
recommended_driver | Signification | Action |
|---|---|---|
motion | Le design utilise motion.dev/framer-motion | Utilisez la syntaxe motion.dev. Voir designs de mouvement avec motion.dev |
css | Le design est purement animation CSS | Utilisez les images clés CSS. Voir designs de mouvement avec CSS |
Étape 4.1 : Générer le code de mouvement
Designs de mouvement avec motion.dev
Lorsque le design doit être implémenté avec motion.dev ou une bibliothèque de mouvement React, générez le code comme suit :
Motion explicite : Utilisez le composant Motion explicitement et mettez les valeurs d'images clés dans l'attribut animate. Utilisez les valeurs de l'extrait motion.dev lorsque disponible.
<motion.div
animate={{
x: [0, 100, 50],
y: [0, -50, 0],
opacity: [1, 0.5, 1],
scale: [1, 1.2, 1],
}}
transition={{
duration: 2, // diviser durationMs par 1000
ease: "easeInOut",
repeat: Infinity, // si la boucle est activée
repeatType: "mirror" // si boomerang
}}
>
- Extrayez les propriétés d'animation de l'extrait motion.dev existant ou des données
keyframeBindings. - Utilisez
durationMs/ 1000 pour la durée. UtilisezdelayMs/ 1000 pour le délai. - Utilisez
keyframeseteasingpour les valeurs clés. - Pour les animations multi-nœuds, créez un composant d'animation partagé ou utilisez des timings coordonnés.
Animation de scroll : Si le design spécifie une animation déclenchée par le défilement, utilisez useInView ou whileInView.
<motion.div
initial={{ opacity: 0, y: 50 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, amount: 0.2 }}
>
- Utilisez les valeurs appropriées
initialetwhileInViewbasées sur l'intention de mouvement du design. - Utilisez
viewport={{ once: true }}pour les animations qui ne se produisent qu'une fois.
Designs de mouvement avec CSS
Lorsque le design doit être implémenté avec des animations CSS, incluez l'intégralité des images clés dans votre composant CSS/SCSS et appliquez l'animation à l'élément cible. Utilisez les extraits CSS/@keyframes directement lorsqu'ils sont disponibles.
@keyframes slideIn {
from {
transform: translateX(-100px);
opacity: 0;
}
to {
transform: translateX(0);
opacity: 1;
}
}
.animated-element {
animation: slideIn 1s ease-out forwards;
}
- Utilisez les extraits CSS trouvés dans
codeSnippetstels quels. Ne les modifiez pas sauf si nécessaire. - Si aucun extrait CSS n'est présent mais que
keyframeBindingsexiste, construisez les images clés à partir des pistes. - Utilisez
durationMs,easing,delayMsetfillModepour les propriétésanimation.
Étape 5 : Valider et itérer
Une fois que vous avez appliqué le mouvement, validez et ajustez :
- Vérifiez que l'animation correspond à l'intention du design (timing, easing, ordre).
- Assurez-vous que l'animation ne casse pas la mise en page ni les fonctionnalités existantes.
- Testez sur différentes tailles d'écran si pertinent.
- Ajoutez des transitions/animations de repli pour les navigateurs qui ne supportent pas certaines fonctions.
- Documentez les compromis ou les décisions prises (par exemple, remplacer une animation complexe par une version simplifiée).
Recommandations framework
Charger references/framework-recommendations.md pour des recommandations spécifiques au framework et des motifs d'adaptation entre motion.dev, Framer Motion, react-spring, GSAP, et les animations CSS pures.
Conseils pour la résolution des problèmes
Charger references/troubleshooting.md pour des problèmes courants et leurs solutions.
Exemples et contre-exemples
Charger references/examples-and-anti-examples.md pour des exemples détaillés du flux de fusion, y compris les cas particuliers et les contre-exemples.
Notes importantes
- Consultez toujours
get_motion_contextcomme source de vérité pour les données d'animation. - Préférez utiliser les extraits de code générés plutôt que de régénérer des animations à partir de zéro.
- Lorsque des décisions de conception doivent être prises (par exemple, comment gérer un cas non pris en charge), communiquez clairement avec l'utilisateur.