Was macht Grundlagen der Bewegung (Motion Foundations)?
Die Basisschicht des Bewegungssystems. Definiert jeden Wert, jede Einschränkung und
Regel, die von nachgelagerten Skills (motion-patterns, motion-advanced) geerbt werden.
Lade diesen Skill, bevor du mit der Animationsarbeit beginnst.
Wann aktivieren
- Wenn du eine animierte Komponente von Grund auf neu erstellst
- Beim Einrichten von Token, Feder-Voreinstellungen oder Beschleunigungswerten
- Bei der Implementierung von
prefers-reduced-motion-Unterstützung - Beim Debuggen von Hydrierungskonflikten durch animierte Initialzustände
- Bei der Bewertung, ob eine Animation überhaupt existieren sollte
Ausgaben
Dieser Skill erzeugt:
- Ein gemeinsames
motionTokens-Objekt (Dauer, Beschleunigung, Distanz, Skalierung) - Eine gemeinsame
springs-Voreinstellungskarte (5 benannte Konfigurationen) - Eine
shouldAnimate()-Schranke, die von allen Komponenten verwendet wird - Barrierefreie Animationsstandards über
useReducedMotion - SSR-sichere Initialzustände ohne Hydrierungswarnungen
Grundsätze
Bewegung muss mindestens eines der folgenden Ziele erfüllen, sonst muss sie entfernt werden:
- Aufmerksamkeit lenken
- Zustand kommunizieren
- Räumliche Kontinuität bewahren
Reaktionsfähigkeit hat immer Vorrang vor Geschmeidigkeit. Eine 60 fps-Animation, die eingabeverzögerungen verursacht, ist schlechter als keine Animation.
Regeln
Diese Regeln sind nicht verhandelbar. Sie gelten für jede Komponente im System.
- Verwende ausschließlich
motion/react. Importiere niemals vonframer-motion. Mische die beiden niemals im selben Baum. initialmuss mit der Serverausgabe übereinstimmen. Wenn der Serveropacity: 1rendert, muss derinitial-Prop ebenfallsopacity: 1sein. Keine Ausnahmen.- Reduzierte Bewegung überschreibt alles. Wenn
useReducedMotion()truezurückgibt oderprefersReducedtrueist, werden alle Transformationen deaktiviert. Nur Opazitäts-Fades mit ≤ 0,2 s sind als Fallback erlaubt. - Layout-Eigenschaften niemals animieren.
width,height,top,left,margin,paddingsind inanimateverboten. Verwende nurtransformundopacity. - Alle Token-Werte stammen aus
motionTokens. Hartcodierte Dauern und Beschleunigungen in Komponentendateien sind verboten. - Alle Feder-Konfigurationen stammen aus der
springs-Map. Inline-stiffness/damping-Werte sind verboten. "use client"ist erforderlich in jeder Datei, die vonmotion/reactimportiert.- Lese
windowodernavigatorniemals auf Modulebene. Schütze sie immer mittypeof window !== "undefined".
Entscheidungshilfe
Auswahl einer Dauer
| Token | Verwende, wenn |
|---|---|
instant | Tooltip ein-/ausblenden, Fokusring, Badge-Update |
fast | Button-Feedback, Icon-Wechsel, Chip-Umschalten |
normal | Modal öffnen, Karte erweitern, Seitenelement eintreten |
slow | Hero-Eingang, vollständiger Seitenübergang |
crawl | Bewusstes Storytelling; sparsam verwenden |
Auswahl einer Feder
| Voreinstellung | Verwende, wenn |
|---|---|
snappy | Standard-UI — Buttons, Chips, Navigationselemente |
gentle | Karten, Modals, Panels, die sanft landen |
bouncy | Verspielte Momente — leere Zustände, Onboarding |
instant | Tooltips, Popover, Dropdowns |
release | Drag-Freigabe — natürliches physikalisches Gefühl |
Wann Animationen vollständig deaktivieren
Deaktiviere (mache shouldAnimate() zu false zurück), wenn:
prefersReducedisttrueisLowEndisttrueund die Animation ist nicht essenziell- Das Element ist außerhalb des Bildschirms und wird niemals in den Viewport gelangen
- Die Animation ist rein dekorativ ohne UX-Zweck
Kernkonzepte
Token-System
// lib/motion-tokens.ts
export const motionTokens = {
duration: {
instant: 0.08,
fast: 0.18,
normal: 0.35,
slow: 0.6,
crawl: 1.0,
},
easing: {
smooth: [0.22, 1, 0.36, 1],
sharp: [0.4, 0, 0.2, 1],
bounce: [0.34, 1.56, 0.64, 1],
linear: [0, 0, 1, 1],
},
distance: {
xs: 4,
sm: 8,
md: 16,
lg: 24,
xl: 48,
},
scale: {
subtle: 0.98,
press: 0.95,
pop: 1.04,
},
}
export const springs = {
snappy: { type: "spring", stiffness: 300, damping: 30 },
gentle: { type: "spring", stiffness: 120, damping: 14 },
bouncy: { type: "spring", stiffness: 400, damping: 10 },
instant: { type: "spring", stiffness: 600, damping: 35 },
release: { type: "spring", stiffness: 200, damping: 20, restDelta: 0.001 },
}
Laufzeit-Flags
// lib/motion-config.ts
export const motionConfig = {
isLowEnd() {
return (
typeof navigator !== "undefined" &&
navigator.hardwareConcurrency <= 4
)
},
prefersReduced() {
return (
typeof window !== "undefined" &&
window.matchMedia("(prefers-reduced-motion: reduce)").matches
)
},
shouldAnimate({ essential = false } = {}) {
if (this.prefersReduced()) return false
if (!essential && this.isLowEnd()) return false
return true
},
duration() {
return this.isLowEnd() || this.prefersReduced()
? motionTokens.duration.instant
: motionTokens.duration.normal
},
}
Barrierefreiheit
Prioritätsreihenfolge (höchste zu niedrigste):
prefers-reduced-motion: reduce— deaktiviert alle Transformationen, begrenzt Opazitätsübergänge auf ≤ 0,2 s- Erkennung von Geräten mit niedriger Leistung — reduziert die Dauer, entfernt nicht-essenzielle Animationen
- Designpräferenz — alles andere
Bewegung muss sich elegant verschlechtern. Sie darf niemals abrupt verschwinden, um Layoutverschiebungen zu verursachen oder die Orientierung zu verwirren.
// hooks/use-reduced-motion.tsx
"use client"
import { useReducedMotion } from "motion/react"
export function useSafeMotion(fullY: number = 16) {
const reduce = useReducedMotion()
return {
initial: { opacity: 0, y: reduce ? 0 : fullY },
animate: { opacity: 1, y: 0 },
exit: { opacity: 0, y: reduce ? 0 : -fullY },
}
}
/* globals.css */
@media (prefers-reduced-motion: reduce) {
.motion-safe-transition { transition: opacity 0.15s; }
.motion-reduce-transform { transform: none !important; }
}
<!-- Tailwind -->
<div class="motion-safe:animate-fade motion-reduce:opacity-100"></div>
SSR- / Hydrierungssicherheit
Regel: initial muss immer mit dem übereinstimmen, was der Server rendert.
// FALSCH — Server rendert opacity:1, aber initial sagt 0 → Hydrierungskonflikt
<motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} />
// RICHTIG — AnimatePresence verwenden oder auf Client-Mount verzögern
"use client"
const [mounted, setMounted] = useState(false)
useEffect(() => setMounted(true), [])
<motion.div
initial={{ opacity: mounted ? 0 : 1 }}
animate={{ opacity: 1 }}
/>
Codebeispiele
Durchgängiges Beispiel: Token + Federn + Barrierefreiheit + SSR-Schutz
// components/fade-in-card.tsx
"use client"
import { useState, useEffect } from "react"
import { motion } from "motion/react"
import { motionTokens, springs } from "@/lib/motion-tokens"
import { useSafeMotion } from "@/hooks/use-reduced-motion"
import { motionConfig } from "@/lib/motion-config"
interface FadeInCardProps {
children: React.ReactNode
delay?: number
}
export function FadeInCard({ children, delay = 0 }: FadeInCardProps) {
// SSR-Schutz — initial muss mit der Serverausgabe übereinstimmen (opacity: 1)
const [mounted, setMounted] = useState(false)
useEffect(() => setMounted(true), [])
// Barrierefreiheit — deaktiviert Transformationen, wenn reduzierte Bewegung bevorzugt wird
const safeMotion = useSafeMotion(motionTokens.distance.md)
// Geräteschranke — Animation auf Geräten mit niedriger Leistung überspringen
if (!motionConfig.shouldAnimate() || !mounted) {
return <div>{children}</div>
}
return (
<motion.div
initial={safeMotion.initial}
animate={safeMotion.animate}
exit={safeMotion.exit}
transition={{
...springs.gentle,
delay,
}}
whileHover={{ scale: motionTokens.scale.pop }}
whileTap={{ scale: motionTokens.scale.press }}
>
{children}
</motion.div>
)
}
Einschränkungen / Nicht-Ziele
Dieser Skill deckt nicht ab:
- UI-Komponentenmuster (Button, Modal, Staffelung) → siehe
motion-patterns - Drag, Gesten, SVG, Textanimationen, benutzerdefinierte Hooks → siehe
motion-advanced - CSS-Only-Animationen oder Tailwind
animate-*-Klassen ohnemotion/react - Animationsbibliotheken von Drittanbietern (GSAP, anime.js usw.)
- Entscheidungen im Bewegungsdesign (wann animieren, was hervorheben) — das ist eine Designfrage, keine Codeeinschränkung
Anti-Patterns
| Anti-Pattern | Verletzte Regel | Korrektur |
|---|---|---|
import { motion } from "framer-motion" | Regel 1 | motion/react verwenden |
initial={{ opacity: 0 }} auf SSR-Komponente | Regel 2 | Mount-Schutz hinzufügen |
useReducedMotion-Prüfung überspringen | Regel 3 | useSafeMotion-Hook verwenden |
animate={{ width: "100%" }} | Regel 4 | Stattdessen scaleX-Transformation verwenden |
transition={{ duration: 0.4 }} inline | Regel 5 | motionTokens.duration.normal verwenden |
{ stiffness: 300, damping: 30 } inline | Regel 6 | springs.snappy verwenden |
Fehlende "use client"-Direktive | Regel 7 | Oben in der Datei hinzufügen |
navigator.hardwareConcurrency auf Modulebene | Regel 8 | In typeof navigator !== "undefined" kapseln |
Verwandte Skills
motion-patterns— verbraucht hier definierte Token und Federn, um Button-, Modal-, Staffelungs-, Seitenübergangs- und Scrollmuster zu erstellen. Definiert keine Werte neu.motion-advanced— verbraucht hier definierte Token und Federn für Drag-, SVG-, Text- und Gestenmuster. FügtuseAnimate-Sequenzen und benutzerdefinierte Hooks auf dieser Grundlage hinzu.