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.mdlistet jedes Pattern mit seiner einzeiligen Regel. - Pattern-Dateien:
references/patterns/<prefix>-<name>.md. Die Präfixe sindmfound(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) undmref(Bewertungsrubrik, Anti-Patterns). - Starter-Tokens:
assets/motion-tokens.css. Namen und Werte für Dauer, Easing und Staffelung entsprechen dashboard-ui'stokens.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'stokens.cssoder 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-*- undprog-*-Patterns. Dieses Skill wiederholt sie nicht.
Workflow
- 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. - 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).
- Ruhe-zu-Ruhe und umgeschaltete (Menüs, Dialoge, Umschalter): eine CSS-Transition (
- 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.
- Platziere es im Raum. Verwende
transform-originam 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 folgemtrans-enter-exit-top-layer.md. - 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).
- 1:1-Verfolgung mit einem Schwellenwert von 10 px (
- Choreografiere, wenn sich mehrere Dinge ändern: Ursache zuerst, dann Eltern, dann Kinder; Staffelung 20–40 ms, begrenzt (
mfound-choreography-and-stagger.md). - 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). - Schreibe die reduzierte Bewegungsversion als Ersetzungen, nicht als Löschungen (
mfound-reduced-motion-vestibular.md). - 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.
- Führe den Anti-Pattern-Durchlauf aus (
Unverhandelbare Regeln
Verstoße nur mit einer schriftlichen Begründung gegen eine dieser Regeln.
Ob und wie lange
- Jede Animation hat einen benannten Zweck. Tastaturgesteuerte und 100+/Tag Aktionen haben keine Animation.
- Die erste visuelle Reaktion erfolgt innerhalb von 100 ms nach Eingabe, unabhängig von der Animationslänge.
- 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.
- Eingänge erleichtern (ease out); Bewegungen auf dem Bildschirm erleichtern ein- und aus (ease in-out); kein
ease-inbei etwas, auf das der Benutzer wartet. Ausgänge sind etwa 0,75× des Eingangs.
Federn und Gesten
- 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.
- Gezogene Elemente verfolgen den Zeiger 1:1 vom Greifpunkt, ohne Transition während des Ziehens. Bestätige einen Zug nach etwa 10 px.
- Beim Loslassen springe zum nächstgelegenen Ziel der projizierten Position und starte die Setz-Feder mit der Loslassgeschwindigkeit.
- Kanten verhalten sich wie ein Gummiband; nichts stoppt hart unter dem Finger.
- 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.
- 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
- Beginne niemals mit
scale(0). Betrete mit Opazität 0 plus Maßstab 0,95–0,97 oder 8–24 px Versatz, mittransform-originam Auslöser. - Verwende
@starting-stylefür den Eintritt unddisplay/overlaymitallow-discretefür den Austritt. Der sichtbare Endzustand ist der Standard, sodass nicht unterstützte Browser trotzdem funktionieren. - 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.
- 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
- Animiere nur Transform-Eigenschaften und Opazität bei allem, was größer als ein kleines Steuerelement ist. Kein
transition: all.will-changeist temporär und folgt nur einer Messung. - Bei
prefers-reduced-motion: reduceersetze räumliche Bewegung durch einen Fade von 150 ms oder weniger, behalte Feedback, behalte 1:1-Ziehverfolgung bei und entferne Prellung. Verwende niemals einen globalen0.01ms-Kill-Switch, und JS-Animationen müssen die Einstellung ebenfalls respektieren. - 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.
- Überprüfe Bewegung anhand aufgenommener Frames, nicht aus dem Code oder dem Gedächtnis.
Entscheidungstabellen
Häufigkeit → Bewegung (mfound-purpose-and-frequency.md)
| Wie oft | Bewegung |
|---|---|
| Tastaturgesteuert oder 100+ Mal am Tag (Grenze des Skills) | Keine |
| Dutzende Male am Tag | 100–150 ms Fade, vielleicht ein kleiner Maßstab; keine Bewegung, keine Prellung |
| Ein paar Mal pro Sitzung | 150–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)
| Situation | Verwende |
|---|---|
| Farbe, Opazität, Zustandsänderung | CSS-Transition, linear oder ease-out |
| Umgeschaltetes Element, das möglicherweise auf halbem Weg umgekehrt wird | CSS-Transition (niemals Keyframes) |
| Ruhe-zu-Ruhe räumliche Bewegung mit Federgefühl | CSS Spring linear() Token plus eigene Dauer |
| Loslassen nach Zug oder Wurf, oder Neuausrichtung mit Geschwindigkeit | JS-Feder (Motion, React Spring, SwiftUI, Compose) |
| Layoutänderung (Neuordnung, Größenänderung, Erweiterung) | FLIP, Motion layout oder eine View Transition |
| Seiten- oder Routenwechsel | View Transition (selbes oder anderes Dokument) |
| Fortschritt durch einen Scroller | Scrollgesteuerte Animation |
Dauer und Easing nach Element (mfound-durations-and-easing.md)
| Element | Dauer | Kurve |
|---|---|---|
| Drücken, Umschalten, Hover | 100 ms | ease-out (Drücken Maßstab 0.97) |
| Tooltip, Menü, Popover | 150 ms ein / 110 ms aus | ease-out ein, ease-in oder Fade aus |
| Dialog, Toast | 240 ms ein / 180 ms aus | ease-out ein, ease-in oder Fade aus |
| Blatt, Schublade | 240–400 ms | --motion-ease-drawer oder eine Feder nach Zug |
| Container-Transformation (Karte → Detail) | 400 ms | betont |
| Routen-Crossfade | 150–250 ms | linear |
Feder-Voreinstellungen (mspring-parameters-and-mapping.md)
| Token | Dauer / Prellung | Verwende |
|---|---|---|
spring-fast | 0,24 s / 0 | Umschalter, kleine Steuerelemente |
spring-default | 0,3 s / 0 | Menüs, Blatt-Setzen, Layout |
spring-slow | 0,45 s / 0 | Vollbild-Oberflächen |
spring-snappy | 0,3 s / 0,15 | Loslassen nach einem Wurf, Einrasten |
spring-playful | 0,4 s / 0,3 | Nur seltene Freude |
Bibliotheksparameter (Motion, React Spring, SwiftUI, Material 3) stammen aus einer Formel in mspring-parameters-and-mapping.md.
Gestenschwellen (mgesture-*)
| Wert | Standard |
|---|---|
| Zugstart / Achsensperre | 10 px |
| Geschwindigkeitsmessfenster | 100 ms |
| Projektionsverzögerung | 0,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-Konstante | 0,55 (die übliche Näherung) |
Token-Standardwerte
Vollständiger Satz in assets/motion-tokens.css.
| Gruppe | Standardwerte |
|---|---|
| Dauer | instant 0 · micro 100 · short 150 · medium 240 · long 400 ms · Ausgangsverhältnis 0,75 |
| Easing | Standard 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) |
| Geometrie | Maßstab-von 0,96 · Drücken 0,97 · Abstand 8 / 16 / 24 px |
| Choreografie | Staffelung 30 ms · max 300 ms (150 ms in Menüs) |
| Reduzierte Bewegung | Räumliche Tokens fallen auf 0 oder 1; Fades behalten ihr Timing |
So wendest du dieses Skill an
- Beim Erstellen:
- Lade
assets/motion-tokens.cssoder 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.
- Lade
- 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.