Bewegung implementieren
Übersicht
Diese Fähigkeit leitet die Übersetzung von Figma-Animationen und -Übergängen in ausführbaren Code (motion.dev, CSS-Keyframes oder frameworkspezifische Bibliotheken) an.
Figma stellt Bewegung über zwei Werkzeuge zur Verfügung:
get_motion_context– das autoritative Bewegungswerkzeug. Gibt das vollständige Inventar animierter Knoten, vorberechnete Code-Snippets (CSS@keyframes+ motion.dev), Fallback-Keyframe-Bindungen, wenn Snippets nicht verfügbar sind, und rekursive Timeline-Koordinationshinweise (timelineCohorts) zurück. Die Quelle der Wahrheit für Animationsdaten und welche Knoten-IDs animieren.get_design_context– die Struktur des Designs: Layout, Größen, Assets, Styling, Code Connect-Hinweise, Screenshot-Kontext und manchmal Bewegungsplatzierungsmarkierungen auf animierten Elementen (data-node-id, und bei geteilten Knotendata-motion-keys/data-motion-wrapper-for/data-motion-transform-template). Es kann einen animierten Knoten als einfaches Element (div,p,spanusw.) oder als Bewegungselement (motion.div) rendern; es fügt die Animationswerte nicht inline ein.
Die beiden sind durch die Knoten-ID verknüpft, und das ist der gesamte Workflow. get_motion_context sagt dir, welche Knoten animieren und gibt die Keyframe-Werte, Easing, Timing und Snippets. get_design_context sagt dir, wie diese Knoten aussehen und wo sie sich befinden. Für jeden Knoten in get_motion_context.nodes findest du das passende data-node-id im Designkontext und führst die Bewegung in diese Struktur ein – indem du ein motion.{tag} hinzufügst oder darum wickelst, wenn das Strukturelement einfach ist. Wenn der Designkontext eine Figma-Komponente wiederverwendet hat, kann der Bewegungsknoten auch fallbackNodeId enthalten; verwende ihn nur als Fallback, nachdem du die genaue nodeId versucht hast.
Grenzen der Fähigkeit
- Verwende diese Fähigkeit, wenn das Ergebnis Bewegungscode im Repository des Benutzers ist.
- Wenn der Benutzer darum bittet, Animationen innerhalb von Figma selbst zu erstellen/bearbeiten, wechsle zu figma-use und folge stattdessen dieser Fähigkeit.
- Diese Fähigkeit deckt derzeit Animationen ab, die von
get_motion_contextausgegeben werden (Snippets plus Fallback-Keyframe-Tracks, einschließlich vorgabenbasierter Bewegung, die in diese Formen aufgelöst wurde). Breitere interaktive Variantenflüsse erfordern möglicherweise noch produktspezifische Zustandsverwaltung im Code.
Voraussetzungen
- Figma MCP-Server verbunden und zugänglich.
- Knoten-ID aus der vom Benutzer bereitgestellten Figma-URL extrahiert. URL-Format:
https://figma.com/design/:fileKey/:fileName?node-id=1-2– extrahierefileKey(das Segment nach/design/) undnodeId(den Wert desnode-id-Abfrageparameters, z. B.42-15).) - Ziel-Codebasis. Das Bewegungsausgabeformat passt sich dem Stack an (siehe Framework-Empfehlungen).
Werkzeugauswahl
Für die Bewegungsimplementierung verwende beide Werkzeuge mit unterschiedlichen Rollen:
| Situation | Werkzeug | Warum |
|---|---|---|
| Verständnis der statischen Struktur, Assets, Styles, Code Connect oder des visuellen Layouts | get_design_context | Gibt die Komponenten-/Seitencode-Referenz und Asset-URLs, die du benötigst, um animierte Knoten korrekt zu platzieren. |
| Abrufen von Animationsdaten für jeden Knoten | get_motion_context | Speziell für Bewegung entwickelt und die Quelle der Wahrheit für Timing, Easing, Snippets und Keyframes. |
Ein Knoten hat Bewegungsmarkierungen (data-motion-keys, data-motion-wrapper-for) | Markierungen für die geteilte Platzierung, get_motion_context für die Werte | Geteilte Markierungen sagen dir, welche Tracks auf welches Element gehen; die Keyframes/Easing/Timing und das Inventar der animierten Knoten kommen von get_motion_context. |
get_motion_context akzeptiert recursive: true (begrenzt auf 500 Knoten), wenn du die Bewegung der Nachkommen in einem Aufruf benötigst.
Erforderlicher Workflow
Schritt 1: Bestätige, dass der statische Designkontext verfügbar ist
get_design_context(fileKey=":fileKey", nodeId="<node-id>")
Wenn get_design_context bereits für diesen Knoten aufgerufen wurde, verwende diese Ausgabe erneut. Wenn nicht, rufe es jetzt normal auf.
Verwende es als Struktur der Aufzeichnung – Hierarchie, Größen, Styling, Assets, Code Connect-Hinweise, Screenshot-Kontext und alle Bewegungsplatzierungsmarkierungen, die es enthält (Schritt 3). Das Inventar der animierten Knoten und die Animationswerte kommen von get_motion_context (Schritt 2).
Schritt 2: Rufe autoritative Bewegungsdaten ab
get_motion_context(fileKey=":fileKey", nodeId="<node-id>", recursive=true)
Antwortform (ein Eintrag pro animiertem Knoten):
codeSnippets– vorab generierte CSS@keyframesund motion.dev-Strings. Verwende diese direkt. Generiere sie nicht aus Fallback-Track-Daten neu.keyframeBindings– gebundene Keyframe-Tracks, einschließlich vorgabenbasierter Bewegung, die in Track-Daten aufgelöst wurde, die nur als Fallback-Daten enthalten sind, wenn beide Snippet-Formate fehlen.motionSummary– eine einzeilige, pro Feld natürlichsprachliche Beschreibung der Animation. Enthalten nur, wenn kein Snippet vorhanden ist (nur Keyframe-Bindings-basierte Bewegungs-Codegenerierung konnte nicht als CSS/motion.dev ausgedrückt werden). Baue darauf auf, wenn vorhanden; ignoriere es, wenn ein Snippet existiert.fallbackNodeId– optionale Fallback-ID für die Zuordnung zu einem komponentisierten Designkontext. WennnodeIdeine instanzqualifizierte ID wieI4005:6111;30:8005ist, kann D2R den wiederverwendbaren Komponentenkörper mit der zugrunde liegenden Komponenten-ID rendern, z. B.4002:3957. In diesem Fall istfallbackNodeIddiedata-node-id, nach der gesucht werden soll, wenn die exaktenodeId-Suche fehlschlägt.
Rekursive Antworten enthalten auch timelineCohorts – ein Array auf oberster Ebene (nicht pro Knoten) von Knoten, die eine Timeline teilen: { rootNodeId, durationMs, loopMode: 'once' | 'loop' | 'boomerang', memberNodeIds[] }. Für koordinierte Multi-Knoten-Bewegung steuere alle memberNodeIds von einem gemeinsamen Lebenszyklus aus, unter Verwendung von durationMs (÷1000 für Sekunden) und loopMode – leite das Timing nicht aus der Geschwisterreihenfolge ab.
Implementierungsdetails, die für LLMs wichtig sind:
- Wenn ein Snippet existiert, können
motionSummary,timelineDurationMsundtransformOriginweggelassen werden, um die Nutzlast zu verkleinern – das Snippet trägt bereits Dauer + Transform-Ursprung (motion.devduration/style={{ transformOrigin }}oder CSSanimation/transform-origin) und die Kohorte trägtdurationMs. Ein fehlendes Feld bedeutet nie "keine Animation". - Rekursive Antworten deduplizieren exakte doppelte Snippets. Ein Snippet kann durch einen Kommentar ersetzt werden, der auf den ersten Knoten mit identischer Bewegung verweist; verwende dieselbe Komponente, Variante, Klasse oder Konstanten erneut, anstatt eine zweite Animation zu schreiben.
- Der MCP-Server schließt aus
clientFrameworksauf CSS- vs. motion.dev-Snippets; wenn die Antwort nur ein Snippet-Format enthält, passe dieses Format an den Stack des Benutzers an, anstatt anzunehmen, dass das andere Format fehlgeschlagen ist.
Schritt 3: Führe statischen und Bewegungskontext zusammen
- Beginne mit
get_motion_context.nodes, nicht mit sichtbarenmotion.*-Tags im statischen JSX. Jeder zurückgegebene Knoten ist animiert. Ordne jeden Bewegungsknoten zuerst anhand der exaktennodeId/data-node-idget_design_contextzu. Wenn und nur wenn es keine exakte Übereinstimmung gibt, versuchefallbackNodeId/data-node-id. Falle nur auf Knotennamen/-typ und Screenshot-Position zurück, nachdem beide IDs fehlgeschlagen sind. - Exakte ID-Übereinstimmung gewinnt vor
fallbackNodeId.fallbackNodeIdzeigt auf die zugrunde liegende Komponenten-ID, die D2R innerhalb einer wiederverwendbaren Komponente ausgeben kann. Sie wird von jeder Instanz dieser Komponente geteilt. Wenn die exaktenodeIdim Designkontext existiert, wende die Bewegung dort an und ignoriere den Fallback. Dies ist entscheidend für die Animation der Stamminstanz: Eine Instanz kann sich anders drehen oder bewegen als eine andere Instanz derselben Komponente, und das Anwenden dieser Bewegung auf den gemeinsam genutzten Komponentenkörper würde alle Instanzen falsch animieren. - Wende jeden Bewegungsknoten auf die passende Designkontext-Struktur an, die durch
data-node-ididentifiziert wird. Die passendedata-node-idist der strukturelle Anker, nicht immer das endgültige DOM-Element, das die Bewegung empfängt. Verwende die Snippet-Form und Platzierungsmarkierungen, um zu entscheiden, ob die Bewegung auf diesem Element, einem Wrapper, einem inneren Element oder einem inline-SVG-Pfad stattfindet.get_design_contextkann bereitsmotion.{tag}mit entfernten Werten ausgeben oder ein einfaches Strukturelement (div,p,span, Komponentenwurzel usw.) ausgeben. Wenn es einfach ist und das Snippet auf das Element selbst abzielt, konvertiere es in das entsprechendemotion.{tag}oder füge einen Bewegungswrapper hinzu, während der Text, die Kinder, Klassen/Styles, Attribute unddata-node-iddes Knotens erhalten bleiben. Lade Referenzen/Beispiele-und-Anti-Beispiele.md, um Beispiele für diesen Zusammenführungsschritt zu sehen. - Komponentisierte Kindbewegung stimmt normalerweise durch Fallback überein. Wenn der Designkontext eine Figma-Instanz in eine wiederverwendbare React-Komponente extrahiert, haben Kinder innerhalb dieses Komponentenkörpers oft zugrunde liegende Komponenten-IDs (
4002:3957), während der Bewegungskontext Live-Instanz-IDs (I4005:6111;30:8005) meldet. Verwende in diesem FallfallbackNodeId, um diedata-node-iddes Komponentenkörpers zu finden, behalte die Bewegung jedoch auf die gerenderte Instanz beschränkt, die du implementierst. Wenn es mehrere Instanzen gibt und nur eine eine andere Stammbewegung hat, hält die exakte ID-Übereinstimmung diese instanzspezifische Bewegung getrennt. - Geteilte Knoten tragen eine
data-motion-keys/data-motion-wrapper-for-Markierung – siehe Umgang mit verschachtelten Transformationen unten. - Behalte
display: contents-Wrapper bei – es sei denn, die Gruppe selbst animiert. Layout-transparente Gruppenwrapper kommen alscontents(Tailwindcontents), normalerweise zusammen mit einem totenabsolute/inset-[…](diese tun nichts bei einercontents-Box). Bei einer statischen Gruppe behaltedisplay: contentsund lasse die Kinder sich gegen den nächstgelegenen echten Vorfahren positionieren – das Konvertieren desinsetdes Wrappers in eine positionierte Box führt dazu, dass die Kinder in eine kleinere Box umgeordnet werden und daher zu klein / nach innen verschoben erscheinen. Bei einer animierten Gruppe (der Gruppenknoten selbst hat Bewegung) kanndisplay: contentskeine Transformation tragen – ersetze es durch einen echten positionierten Wrapper und wende die Gruppenbewegung dort an. Lade Referenzen/Stolperfallen.md, bevor du diesen Fall implementierst. get_motion_contextist das vollständige Inventar der animierten Knoten. Einige animierte Knoten werden als einfache (nichtmotion) Elemente gerendert – Komponenteninstanzwurzeln (einfach positionierendes<div>), Text (<p>), Masken – die dennoch eindata-node-idtragen. Gehe jeden Knoten in der Bewegungsantwort durch und wende seine Bewegung auf das Element mit der passendendata-node-idan, wobei du es bei Bedarf umschließt oder konvertierst. Wenn ein animierter Knoten überhaupt kein Element in der Ausgabe hat (z. B. eine animierte Maske, die in ein statischesmask-imageabgeflacht wurde), lösche ihn nicht stillschweigend – hinterlasse einen// TODO: <nodeId> Bewegung nicht unterstützt-Kommentar und weise in deiner Zusammenfassung darauf hin.- Wenn ein Knoten im Bewegungskontext, aber nicht im statischen JSX erscheint, füge das zu seiner Darstellung erforderliche Element hinzu – der Code des Designkontexts ist eine Referenz, kein vollständiges Animationsinventar.
- Bei Konflikten zwischen Design- und Bewegungskontext (Timing/Easing/animierte Werte) bevorzuge
get_motion_context. - SVG-Bewegung auf Pfadebene: Das SVG inline einbetten und das echte
<path>animieren. Wennget_motion_contextauf den Pfad eines Vektors abzielt (PATH_TRIM,motion.path,stroke-dasharray), der Designkontext es jedoch als<img>rendert, bette das SVG inline ein und wende das Snippet auf den<path>an, wobei der Layout-Wrapper erhalten bleibt. Lade Referenzen/svg-und-pfad-bewegung.md für die vollständige Anleitung für diesen Fall (motion.path,pathLength="1", Wrapper+Path-Schichtung, CSS-Pfad-Trim).
Umgang mit verschachtelten Transformationen
Ein Knoten mit sowohl einer statischen Basistransformation als auch animierten Transformationen wird über verschachtelte Elemente aufgeteilt, sodass die beiden korrekt zusammenspielen, anstatt sich zu widersprechen: Ein id-loses motion.div, das data-motion-wrapper-for="<nodeId>" trägt (der ÄUSSERE Wrapper) umschließt ein statisches Transform-div (z. B. rotate-45 + hypot()-Größenbestimmung – oder der Wrapper selbst trägt data-motion-transform-template="<css>"), das den INNEREN Knoten umschließt (data-node-id). Behalte die Verschachtelung Wrapper > statisch-transform-div > Inneres bei – das Auflösen bricht die Größenbestimmung und die Basistransformation.
- Platziere Tracks nach
data-motion-keys. Diedata-motion-keysdes Wrappers (Transform-Tracks –x/y/rotate/scaleX/scaleY/skewX) gehen auf den ÄUSSEREN Wrapper; diedata-motion-keysdes inneren Elements gehen auf das INNERE Element. - Wende ein
data-motion-transform-templateerneut an. Wenn der Wrapper eines trägt, setzetransformTemplate={(_, generated) => "<css> " + generated}, sodass die animierte Transformation auf dieser statischen Layout-Transformation aufbaut. - Verschiebe die animierte Transformation um die statische Basis (doppelte Drehung vermeiden).
get_motion_contextgibt die absolute Transformation des Knotens, die bereits die statische Basis enthält, die diese Divs anwenden. Einrotate-Snippet von[45, 125, 125]über einerrotate-45-Basis bedeutet, dass der Wrapper den Offset[0, 80, 80](= absolute − 45) animiert, nicht das Absolute – sonst wird die 45° zweimal angewendet und das Element sitzt im Ruhezustand bei 90°. Tracks ohne statische Basis (z. B.x/ybeginnend bei 0) werden unverändert durchgereicht. Siehe das Beispiel für verschachtelte Transformationen. - Halte Layout-Transformationen getrennt von Motion-Transformationen. Überprüfe für jedes
motion.*-Element, dasrotate,scaleoderskewanimiert, dass es nicht auch auf Tailwind-Layout-Transformationen wie-translate-x-1/2oder-translate-y-1/2für Zentrierung/Positionierung angewiesen ist. Diese Hilfsprogramme teilen sich die CSStransform-Eigenschaft, die Motion.dev inline schreibt, sodass die Motion-Transformation die Layout-Übersetzung löschen kann. Wenn beides benötigt wird, teile das Element in einen statischen Layout-Wrapper, der die Zentrierungs-/Positionierungstransformation trägt, und ein inneresmotion.*-Element, das die animierte Drehung/Skalierung/Deckkraft trägt, oder kodiere den Layout-Offset in Motion selbst (x: "-50%") und behalte ihn für jeden Keyframe bei.
Schritt 4: Wende die Bewegung im Code an
-
Sind motion.dev-Snippets vorhanden? Verwende den motion.dev-Code wörtlich für React-Ziele. Importiere von
motion/react– es sei denn, die Codebasis verwendet bereits eine andere Motion-Bibliothek (Framer Motion, React Spring, GSAP), in diesem Fall passe das Snippet daran an. Lade Referenzen/framework-empfehlungen.md, wenn du an einen anderen Stack anpasst oder eine Bibliothek auswählst. -
Sind CSS-Keyframes vorhanden? Verwende für Vanilla-/Nicht-React-Ziele oder wenn die Codebasis keine React-Motion-Bibliothek hat.
-
Keine Snippets (nur Keyframe-Bindings)? Baue äquivalente motion.dev-/CSS-Animationen aus den
keyframeBindings-Trackdaten. Extrahiere die globaledurationMsaus dem Keyframe-Set und leite aus dem Track selbst ab, welche Eigenschaft animiert wird (z. B.key: "rotate"→rotate). Wende jeden Track als Keyframe-Sequenz auf das Element an. Wenn kein Bindungsset einedurationMsangibt, suche nach der Kohorten-durationMsauf Knotenebene odertimelineCohorts; diese sind für das obige Timing vorhanden. Erzeuge@keyframes-Regeln oder motion.dev-Aufrufe, keine veralteten. -
Nur
motionSummary(kein Snippet, keine Bindungen)? Der Figma-Node enthielt eine vorgabenbasierte Bewegung, die der Server nicht in Track-Daten oder Snippets auflösen konnte. Diese Vorgabe kann eine andere sein als die, die du sehen konntest. Baue die Animation aus der Zusammenfassung mitanimate(motion.dev) oderanimation(CSS). VerwendemotionSummaryals Entwicklerbeschreibung – Code, den du erzeugst, sollte den beabsichtigten Effekt der Vorgabe widerspiegeln, nicht die genaue Wortwahl. -
Baue die Bewegung für den Stack (siehe Framework-Empfehlungen):
- React/Next.js (motion.dev vorhanden?):
import { motion } from 'motion/react'und verwende die Snippets direkt. - React (keine motion.dev-Abhängigkeit?): Füge
motionhinzu, wenn das Projekt neu ist oder bereits Framer Motion/React Spring hat. Wenn weder noch, frage den Benutzer. - Vanilla JS / statischer HTML: CSS
@keyframesundanimation-Eigenschaft.
- React/Next.js (motion.dev vorhanden?):
Schritt 5: Koordinierte Multi-Knoten-Bewegung
Wenn get_motion_context timelineCohorts zurückgibt:
- Identifiziere die
rootNodeId-Start- und -Stoppebene. - Wende die
durationMs(geteilt durch 1000 für motion.dev-Sekunden) undloopMode('once'→repeat: 0,'loop'→repeat: Infinity,'boomerang'→direction: 'alternate') auf die gesamte Kohorte an. - Verwende einen einzigen
animate-Aufruf, der alle Mitglieder umfasst (motion.dev<AnimatePresence>mitvariantsoderwhileInView/initial+animateauf einem Container; oder CSSanimationauf jedem Mitglied mit derselbenanimation-durationundanimation-iteration-count). - Passe die Reihenfolge der Geschwister nicht manuell an;
timelineCohortsliefert das Timing.
Schritt 6: Validierung
- Überprüfe, dass die Bewegung in der Zielumgebung ausgeführt wird. Gehe nicht davon aus, dass Snippets fehlerfrei sind.
- Bestätige, dass
display: contents-Wrapper korrekt sind (siehe Stolperfallen.md). - Bestätige, dass SVG-Pfad-Bewegung das Bild ersetzt (siehe svg-und-pfad-bewegung.md).
- Bestätige, dass die exakte
nodeId-Übereinstimmung vorfallbackNodeIdgewinnt. - Vermeide doppelte Dauer: Verschachtle nie
durationinnerhalb einer Keyframe-Sequenz UND als Stammoption – motion.dev summiert sie und verdoppelt effektiv die Wiedergabezeit. - Bestätige, dass die Layout-Transformation nicht mit der Motion-Transformation kollidiert (siehe Abschnitt über verschachtelte Transformationen).
Häufige Probleme
-
display: contents+ absolute Positionierung – Der Wrapper wird zucontentsdekoriert; die absolute Positionierung tut nichts. Wenn du dasabsolute/insetbeibehältst, aberdisplay: contentsdurch eine echte Box ersetzt, wird die Gruppengröße ignoriert und die Kinder werden auf einen kleineren Bereich positioniert → unerwartet kleine/schräge Darstellung. Siehe Stolperfallen.md. -
Figma-Komponente mehrmals verwendet, aber Bewegung nur auf einer Instanz –
fallbackNodeIdwürde die Bewegung auf allen teilen. Die exaktenodeId-Übereinstimmung verhindert dies. -
Path-Trim-Bewegung mit einem
<img>– Figma stellt möglicherweise das SVG als Bild dar, aberPATH_TRIMbenötigt ein echtes<path>. Betten Sie das SVG inline ein und wenden Siemotion.pathan. -
Doppelte Bewegung von Keyframes und Stamm-
animate– Verwende entweder Keyframes ODER eineanimate-Eigenschaft auf Elementebene, nicht beides.
Framework-Empfehlungen
default motion/react
Vollständige Dokumentation: Referenzverzeichnis