Communitygithub.com

motion-ui

Zeigt einem Agenten, wie in die Praxis umgesetzt wird – von der Planung über die Umsetzung bis zum Design-System mit Tokens. Das Vorgehen gliedert sich in Motion UI, Workflow und Non-negotiables. Verwende dieses Skill, wenn eine neue Aufgabe diese Disziplin erfordert.

Was ist motion-ui?

Das Motion-UI-Skill ist ein forschungsgestützter Leitfaden für Produkt-UI-Bewegungen und Gesten, bestehend aus 19 Pattern-Dateien mit Regeln, Anti-Patterns, Referenzen, Barrierefreiheit, Tokens, Implementierungsskizzen und Checklisten. Es richtet sich an Entwickler, die konsistente, performante und barrierefreie Animationen in Web- und App-Oberflächen umsetzen möchten. Das Skill unterstützt CSS-Transitionen, JS-Federn, View Transitions, scrollgesteuerte Animationen und Gestensteuerung. Es definiert klare Workflow-Schritte, zwingende Regeln (Non-negotiables) und Entscheidungstabellen für Timing, Mechanismus und Choreografie. Besonderes Augenmerk liegt auf Reduzierung von Bewegungen für Barrierefreiheit, Unterbrechbarkeit und Performance. Die beiliegenden CSS-Token-Definitionen (Dauer, Easing, Federn) können direkt in Projekte eingebunden oder an bestehende Designsysteme angepasst werden.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Motion UI

Ein forschungsgestützter Leitfaden für Produkt-UI-Bewegung und Gesten: 19 Pattern-Dateien, jede mit Regeln, Anti-Patterns, guten und schlechten Referenzen, Barrierefreiheit, Tokens, einer Implementierungsskizze und einer Checkliste. Diese Datei enthält den Workflow, die unverhandelbaren Regeln, die Entscheidungstabellen und die Token-Standardwerte. Öffne die Pattern-Dateien für Details.

  • Pattern-Index: references/INDEX.md listet jedes Pattern mit seiner einzeiligen Regel.
  • Pattern-Dateien: references/patterns/<prefix>-<name>.md. Die Präfixe sind mfound (Zweck, Timing, Choreografie, reduzierte Bewegung), mspring (Federn), mgesture (Ziehen, Schwung, Kanten, Blätter, Unterbrechung), mtrans (Ein-/Ausblenden, räumlicher Ursprung, Routenübergänge, Mikrointeraktionen, scrollgesteuert), mperf (Performance) und mref (Bewertungsrubrik, Anti-Patterns).
  • Starter-Tokens: assets/motion-tokens.css. Namen und Werte für Dauer, Easing und Staffelung entsprechen dashboard-ui's tokens.css. Es funktioniert eigenständig in hellen und dunklen Modi: Die gelesenen dashboard-ui-Rollen-Tokens werden mit null Spezifität deklariert, sodass dashboard-ui's tokens.css oder die eigenen Tokens des Projekts mit denselben Rollennamen sie in jeder Lade-Reihenfolge überschreiben.
  • Daten-UIs: Für Zahlen-Tweens, Diagrammübergänge, verknüpfte Exploration, Live-Neuberechnung und Ladezustände verwende dashboard-ui's motion-*- und prog-*-Patterns. Dieses Skill wiederholt sie nicht.

Workflow

  1. Entscheide, ob es sich überhaupt bewegen soll. Benenne den Zweck: Feedback, Kontinuität, Orientierung, Aufmerksamkeit oder (selten) Freude. Schätze ein, wie oft es vorkommt und ob es von der Tastatur ausgelöst wird, wähle dann die Zeile in der Häufigkeitstabelle unten (mfound-purpose-and-frequency.md). Wenn es keinen Zweck gibt oder die Aktion tastaturgesteuert ist oder 100+ Mal am Tag vorkommt, stoppe: keine Animation.
  2. Wähle den Mechanismus.
    • Ruhe-zu-Ruhe und umgeschaltete (Menüs, Dialoge, Umschalter): eine CSS-Transition (mfound-durations-and-easing.md) oder ein Spring-linear()-Token (mspring-css-linear-and-tokens.md).
    • Von einem Finger oder Zeiger gesteuert, oder mit Geschwindigkeit unterbrechbar: eine JS-Feder (mspring-parameters-and-mapping.md, mgesture-interruptibility-and-velocity.md).
    • Navigation: View Transitions (mtrans-view-transitions-and-routes.md).
    • An die Bildlaufposition gebunden: scrollgesteuerte Animation (mtrans-scroll-driven-animations.md).
  3. Setze das Timing anhand von Tokens fest. Dauer pro Element, Easing nach Richtung, Ausgänge mit 0,75× des Eingangs, und Federn als Dauer plus Prellung. Verwende niemals Rohwerte in Komponenten.
  4. Platziere es im Raum. Verwende transform-origin am Auslöser, spiegele Ausgänge, halte Vorwärts- und Rückwärtsbewegung konsistent und lasse persistentes Chrome stillstehen (mtrans-spatial-origin-and-continuity.md). Für Ein-/Ausgänge von Top-Layer-Elementen folge mtrans-enter-exit-top-layer.md.
  5. Für Gesten, wende in dieser Reihenfolge an:
    • 1:1-Verfolgung mit einem Schwellenwert von 10 px (mgesture-direct-manipulation-drag.md);
    • Projektion und Geschwindigkeit beim Loslassen (mgesture-momentum-projection-and-snap.md);
    • gummibandartige Kanten (mgesture-rubber-banding-and-bounds.md);
    • die Blatt- und Wischregeln (mgesture-sheets-and-swipe-to-dismiss.md).
  6. Choreografiere, wenn sich mehrere Dinge ändern: Ursache zuerst, dann Eltern, dann Kinder; Staffelung 20–40 ms, begrenzt (mfound-choreography-and-stagger.md).
  7. Halte es günstig. Animiere nur Transform und Opazität, verwende kein globales will-change, und zeichne Feedback im nächsten Frame (mperf-compositor-will-change-and-inp.md).
  8. Schreibe die reduzierte Bewegungsversion als Ersetzungen, nicht als Löschungen (mfound-reduced-motion-vestibular.md).
  9. Prüfe anhand von Frames.
    • Führe den Anti-Pattern-Durchlauf aus (mref-anti-patterns-gallery.md).
    • Erstelle Frame-Streifen (4× verlangsamt, volle und reduzierte Bewegung, plus einen unterbrochenen Durchlauf) und das In-Page-Audit.
    • Bewerte die 18-Punkte-Rubrik (mref-motion-review-rubric.md). Ausliefern bei 80 % oder mehr, ohne einen Must-Check bei 0.
    • Melde jeden Befund als Prüf-ID · Beleg · Korrektur, plus was du nicht geprüft hast.

Unverhandelbare Regeln

Verstoße nur mit einer schriftlichen Begründung gegen eine dieser Regeln.

Ob und wie lange

  1. Jede Animation hat einen benannten Zweck. Tastaturgesteuerte und 100+/Tag Aktionen haben keine Animation.
  2. Die erste visuelle Reaktion erfolgt innerhalb von 100 ms nach Eingabe, unabhängig von der Animationslänge.
  3. Dauern stammen aus Tokens (100 / 150 / 240 / 400 ms). Nichts in der UI-Chrome läuft über 400 ms; nur seltene Momente dürfen 600 ms erreichen.
  4. Eingänge erleichtern (ease out); Bewegungen auf dem Bildschirm erleichtern ein- und aus (ease in-out); kein ease-in bei etwas, auf das der Benutzer wartet. Ausgänge sind etwa 0,75× des Eingangs.

Federn und Gesten

  1. Federn werden als Dauer + Prellung geschrieben. Verwende Prellung 0 für UI-Chrome, 0.1–0.2 nur nach einer Geste mit Schwung, und niemals bei Opazität, Farbe oder Datenwerten.
  2. Gezogene Elemente verfolgen den Zeiger 1:1 vom Greifpunkt, ohne Transition während des Ziehens. Bestätige einen Zug nach etwa 10 px.
  3. Beim Loslassen springe zum nächstgelegenen Ziel der projizierten Position und starte die Setz-Feder mit der Loslassgeschwindigkeit.
  4. Kanten verhalten sich wie ein Gummiband; nichts stoppt hart unter dem Finger.
  5. Alles, was der Benutzer beeinflussen kann, ist von seinem aktuellen Bildschirmwert aus unterbrechbar. Es gibt keine Animationswarteschlangen und keine blockierte Eingabe während der Bewegung. Umgeschaltete UIs verwenden Transitionen, keine Keyframes.
  6. Destruktive Gesten-Aktionen werden beim Loslassen bestätigt und bieten Rückgängig. Jede Geste hat ein Tasten- oder Tastaturäquivalent (WCAG 2.5.7).

Eingang, Ausgang und Navigation

  1. Beginne niemals mit scale(0). Betrete mit Opazität 0 plus Maßstab 0,95–0,97 oder 8–24 px Versatz, mit transform-origin am Auslöser.
  2. Verwende @starting-style für den Eintritt und display/overlay mit allow-discrete für den Austritt. Der sichtbare Endzustand ist der Standard, sodass nicht unterstützte Browser trotzdem funktionieren.
  3. Routenübergänge sind progressive Verbesserung. Bereite zuerst Daten vor, dann den Übergang. Verwende den Standard-Crossfade oder einen 16–24 px Richtungswechsel, benenne 1–3 gemeinsame Elemente und verschiebe den Fokus danach.
  4. Toasts enthalten niemals die einzige Kopie einer Information. Fehler werden nie automatisch geschlossen; ein Rückgängig-Toast bleibt mindestens 8 s sichtbar und seine Aktion existiert auch außerhalb des Toasts. Timer pausieren bei Hover, Fokus und versteckten Tabs (dashboard-ui comp-notifications-alerts.md).

Performance und Sicherheit

  1. Animiere nur Transform-Eigenschaften und Opazität bei allem, was größer als ein kleines Steuerelement ist. Kein transition: all. will-change ist temporär und folgt nur einer Messung.
  2. Bei prefers-reduced-motion: reduce ersetze räumliche Bewegung durch einen Fade von 150 ms oder weniger, behalte Feedback, behalte 1:1-Ziehverfolgung bei und entferne Prellung. Verwende niemals einen globalen 0.01ms-Kill-Switch, und JS-Animationen müssen die Einstellung ebenfalls respektieren.
  3. Kein Parallax, Scroll-Jacking, Vollbild-Zoom oder endlose Schleifenbewegung in der Produkt-UI. Autoplay über 5 s hat eine Pausensteuerung, und nichts blinkt mehr als dreimal pro Sekunde.
  4. Überprüfe Bewegung anhand aufgenommener Frames, nicht aus dem Code oder dem Gedächtnis.

Entscheidungstabellen

Häufigkeit → Bewegung (mfound-purpose-and-frequency.md)

Wie oftBewegung
Tastaturgesteuert oder 100+ Mal am Tag (Grenze des Skills)Keine
Dutzende Male am Tag100–150 ms Fade, vielleicht ein kleiner Maßstab; keine Bewegung, keine Prellung
Ein paar Mal pro Sitzung150–240 ms, darf sich 8–24 px bewegen
Selten (erster Durchlauf, großer Erfolg)Bis zu 400–600 ms, eine Feder mit Prellung erlaubt

Mechanismus (mspring-parameters-and-mapping.md, mspring-css-linear-and-tokens.md)

SituationVerwende
Farbe, Opazität, ZustandsänderungCSS-Transition, linear oder ease-out
Umgeschaltetes Element, das möglicherweise auf halbem Weg umgekehrt wirdCSS-Transition (niemals Keyframes)
Ruhe-zu-Ruhe räumliche Bewegung mit FedergefühlCSS Spring linear() Token plus eigene Dauer
Loslassen nach Zug oder Wurf, oder Neuausrichtung mit GeschwindigkeitJS-Feder (Motion, React Spring, SwiftUI, Compose)
Layoutänderung (Neuordnung, Größenänderung, Erweiterung)FLIP, Motion layout oder eine View Transition
Seiten- oder RoutenwechselView Transition (selbes oder anderes Dokument)
Fortschritt durch einen ScrollerScrollgesteuerte Animation

Dauer und Easing nach Element (mfound-durations-and-easing.md)

ElementDauerKurve
Drücken, Umschalten, Hover100 msease-out (Drücken Maßstab 0.97)
Tooltip, Menü, Popover150 ms ein / 110 ms ausease-out ein, ease-in oder Fade aus
Dialog, Toast240 ms ein / 180 ms ausease-out ein, ease-in oder Fade aus
Blatt, Schublade240–400 ms--motion-ease-drawer oder eine Feder nach Zug
Container-Transformation (Karte → Detail)400 msbetont
Routen-Crossfade150–250 mslinear

Feder-Voreinstellungen (mspring-parameters-and-mapping.md)

TokenDauer / PrellungVerwende
spring-fast0,24 s / 0Umschalter, kleine Steuerelemente
spring-default0,3 s / 0Menüs, Blatt-Setzen, Layout
spring-slow0,45 s / 0Vollbild-Oberflächen
spring-snappy0,3 s / 0,15Loslassen nach einem Wurf, Einrasten
spring-playful0,4 s / 0,3Nur seltene Freude

Bibliotheksparameter (Motion, React Spring, SwiftUI, Material 3) stammen aus einer Formel in mspring-parameters-and-mapping.md.

Gestenschwellen (mgesture-*)

WertStandard
Zugstart / Achsensperre10 px
Geschwindigkeitsmessfenster100 ms
Projektionsverzögerung0,998 pro ms (0,99 für schnelles Blättern)
Wurf bestätigt> 400 px/s
Blatt schließt> 25 % seiner Höhe gezogen oder ein Wurf
Gummiband-Konstante0,55 (die übliche Näherung)

Token-Standardwerte

Vollständiger Satz in assets/motion-tokens.css.

GruppeStandardwerte
Dauerinstant 0 · micro 100 · short 150 · medium 240 · long 400 ms · Ausgangsverhältnis 0,75
EasingStandard cubic-bezier(0.2,0,0.38,0.9) · Eingang (0,0,0.38,0.9) · Ausgang (0.2,0,1,0.9) · betont (0.2,0,0,1) · Schublade (0.32,0.72,0,1)
Federn (CSS)--motion-spring-{fast,default,slow,snappy,playful} mit passender -dur (360 / 450 / 670 / 420 / 660 ms)
GeometrieMaßstab-von 0,96 · Drücken 0,97 · Abstand 8 / 16 / 24 px
ChoreografieStaffelung 30 ms · max 300 ms (150 ms in Menüs)
Reduzierte BewegungRäumliche Tokens fallen auf 0 oder 1; Fades behalten ihr Timing

So wendest du dieses Skill an

  • Beim Erstellen:
    • Lade assets/motion-tokens.css oder ordne es den Tokens des Projekts zu.
    • Bevorzuge Plattformfunktionen: CSS-Transitionen, @starting-style, <dialog> und die Popover-API, View Transitions, scrollgesteuerte Animationen, linear(). Greife nur für Gesten und Geschwindigkeit zu einer JS-Bibliothek.
    • Verwende niemals den TypeScript any-Typ.
  • Beim Prüfen: Nimm zuerst Frames auf, dann führe die Anti-Pattern-Galerie und die Rubrik durch. Melde eine Tabelle mit Prüfung, Punktzahl, Beleg und Korrektur, geordnet nach Schweregrad, und liste auf, was du nicht geprüft hast.
  • Wenn das Projekt ein Bewegungssystem hat (M3, Carbon, eigene Tokens): Seine Tokens gewinnen. Ordne sie diesen Rollen zu und markiere die Lücken.
  • Wenn Regeln widersprechen: Barrierefreiheit und die Kontrolle des Benutzers (reduzierte Bewegung, Unterbrechbarkeit, kein Scroll-Jacking) schlagen Ausdruckskraft, und Häufigkeit schlägt Freude.

Individual skills in this repo

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

Verwandte Skills