UI-Bewegungsmuster (Motion Patterns)
Zwei Aufgaben: Live-Produkt-UI im Web animieren und Produkt-UI für Videos originalgetreu nachbilden, ohne sie neu zu gestalten. Beide nutzen dieselben Tokens.
1. Tokens zuerst
Bewegung einmal definieren und überall importieren. Keine Inline-Zahlen in Komponenten.
// lib/motion-tokens.ts
export const motionTokens = {
duration: { instant: 0.1, fast: 0.18, normal: 0.3, slow: 0.5, scene: 0.7 },
easing: {
standard: [0.2, 0, 0, 1], // Eintritt + Bewegung
exit: [0.4, 0, 1, 1], // Austritt
emphasized: [0.3, 0, 0, 1],
},
distance: { nudge: 4, small: 8, medium: 16, large: 32 },
stagger: 0.06, // zwischen 0.05 und 0.10 halten
} as const;
export const springs = {
press: { type: "spring", stiffness: 600, damping: 38 }, // Buttons, Toggles
snappy: { type: "spring", stiffness: 420, damping: 34 }, // Chips, Menüs
gentle: { type: "spring", stiffness: 260, damping: 27 }, // Karten, Panels
layout: { type: "spring", stiffness: 320, damping: 30 }, // Neu anordnen, Größe ändern
camera: { type: "spring", stiffness: 140, damping: 20 }, // Große Bewegungen, nur Video
} as const;
Mit Masse 1, Dämpfungsverhältnis ζ = damping / (2·√stiffness): press 0.78, snappy 0.83, gentle 0.84, layout 0.84, camera 0.85 – alle innerhalb des 0.75–0.90-Bands (Überschwingen ≤ ~6 %). Pro Marke mit dieser Formel anpassen und diese Tabelle als einzige Quelle beibehalten.
2. Barrierefreiheit und SSR
"use client";
import { useReducedMotion } from "motion/react";
export function useSafeMotion() {
const reduce = useReducedMotion();
return {
reduce,
// reduzierte Bewegung: Transforms weglassen, kurze Opacity-Änderungen beibehalten (≤0,2 s)
enter: reduce ? { opacity: 1 } : { opacity: 1, y: 0 },
initial: reduce ? { opacity: 0 } : { opacity: 0, y: 8 },
transition: reduce ? { duration: 0.2 } : undefined,
};
}
initial={false}für Elemente verwenden, die bereits beim ersten Paint sichtbar sind, um Hydrations-Flicker zu vermeiden.- Nur
transformundopacityanimieren. Niemalswidth,height,top,leftoderbox-shadowin Schleifen animieren; stattdessenlayoutoder Scale verwenden. - Geräte mit geringer Leistung: Dauer verkürzen und dekorative Bewegungen auslassen.
3. Muster und ihre Regeln
| Muster | Regel |
|---|---|
| Button-Druck | whileTap={{ scale: 0.96 }} mit springs.press; Feedback innerhalb von 100 ms |
| Bedingtes Rendern | in AnimatePresence mit stabilem key einwickeln; jedes initial + animate erhält ein exit |
| Seiten-/Routen-Übergang | AnimatePresence mode="wait": Austritt abgeschlossen vor Eintritt |
| Listen-Staffelung | staggerChildren 0,05–0,10 s; gestaffelte Elemente auf ~8 begrenzen, der Rest erscheint gemeinsam |
| Neu anordnen / Größe ändern | layout nur auf kleinen Unterbäumen (≲5 Kinder); sonst explizites x/y |
| Modal / Sheet | Fokus-Falle, Escape schließt, Scroll-Sperre, role="dialog", aria-modal="true", Fokus zurückgeben |
| Toast | tritt von der Kante ein, auf der er lebt; automatisches Ausblenden pausiert bei Hover/Fokus |
| Zahlenänderung | vertikaler Roll: alter Wert mit Unschärfe nach oben aus, neuer von unten ein; font-variant-numeric: tabular-nums |
| Scroll-Enthüllung | whileInView mit viewport={{ once: true }}; niemals beim Rausscrollen erneut animieren |
| Laden → Erfolg | Button komprimiert → Spinner → Haken; die Button-Breite stabil halten |
4. Produkt-UI für Video nachbilden
- Messen, nicht raten. Tokens aus der Produktquelle oder berechneten Styles entnehmen: Farben, Radien, Schriftfamilie/-gewichte/-spationierung, Abstände, Symbolset und Strichstärke. Farben aus echten Screenshots abtasten und vergleichen.
- Hybrid-Standard. Echten Screenshot als Kontext; nur die Elemente nachbilden, die animieren, pixelgenau darüber platziert.
- Nie neu gestalten ohne ausdrückliche Genehmigung. Keine neuen Farben, Schriftarten, Symbole oder Textinhalte.
- Sauber erfassen. Abgemeldet oder mit Demo-Konto, fiktiven Daten, keine personenbezogenen Daten, keine Marken Dritter, es sei denn, der Benutzer besitzt sie.
- Suchbar. Im Video jeden animierten Wert von der absoluten Zeit ableiten (
value = f(t)), nicht vommotion/react-Laufzeitzustand.motion/reactfür das Live-Web verwenden, geschlossene Federn oder GSAP-Zeitachsen für gerenderte Videos.
Wenn diese Muster auf einer Website anstelle eines Videos verwendet werden, vor der Auslieferung das Prüf-Gate design-expert ausführen (Tastatur, Fokus, reduzierte Bewegung, Leistung).