Wenn diese Fähigkeit aktiviert ist, beginnen Sie Ihre erste Antwort immer mit dem 🧢-Emoji.
Motion Design
Eine fokussierte, meinungsstarke Wissensbasis für die Implementierung von Animationen und Bewegungen in Webanwendungen. Behandelt CSS-Übergänge und Keyframes, Framer Motion, GSAP, scrollgesteuerte Animationen und Mikrointeraktionen – mit konkretem Code für jedes Muster. Jede Empfehlung priorisiert 60fps-Leistung, Barrierefreiheit und zielgerichtete Bewegung vor Dekoration.
Der Unterschied zwischen guten und schlechten Animationen liegt in der Zurückhaltung. Die meisten UIs brauchen weniger Animationen, nicht mehr. Wenn Bewegung vorhanden ist, muss sie schnell, flüssig sein und die Benutzerpräferenzen respektieren.
Wann diese Fähigkeit zu verwenden ist
Lösen Sie diese Fähigkeit aus, wenn der Benutzer:
- Bittet, Animationen oder Übergänge zu einem UI-Element hinzuzufügen
- Ein- und Ausgangsanimationen für Komponenten benötigt, die montiert oder demontiert werden
- Seitenübergänge oder Routenwechsel-Animationen implementieren möchte
- Nach Framer Motion, GSAP oder CSS-Animation-APIs fragt
- Scrollgesteuerte Animationen oder Parallaxeneffekte benötigt
- Ladezustände mit Skeleton-Screens oder Spinnern haben möchte
- Nach Federphysik, Beschleunigungskurven oder Animationszeitsteuerung fragt
- Eine GSAP-Zeitachse für komplexe mehrstufige Sequenzen benötigt
- Nach Mikrointeraktionen (Hover, Drücken, Umschalten, Kontrollkästchen-Zustände) fragt
Diese Fähigkeit NICHT auslösen für:
- Reines CSS-Layout oder Styling ohne Bewegung (stattdessen ultimate-ui verwenden)
- Canvas- oder WebGL-Rendering (stattdessen eine grafik spezifische Ressource verwenden)
Schlüsselprinzipien
-
Bewegung sollte einen Zweck haben – Jede Animation muss etwas kommunizieren: Zustandsänderung, räumliche Beziehung, Feedback oder Hierarchie. Bewegungen nur zur Dekoration sind Rauschen. Fragen Sie „Was sagt diese Animation dem Benutzer?“, bevor Sie sie hinzufügen.
-
prefers-reduced-motionrespektieren – Wickeln Sie Animationen immer in eineprefers-reduced-motion-Abfrage ein. Benutzer mit vestibulären Störungen oder Epilepsie können durch Bewegungen geschädigt werden. Dies ist eine WCAG-2.1-AA-Anforderung, kein Vorschlag. -
Nur Transformationen und Deckkraft animieren –
transformundopacitysind die einzigen Eigenschaften, die der Browser auf dem Compositor-Thread animieren kann, ohne Layout oder Paint auszulösen. Das Animieren vonwidth,height,top,left,marginoderpaddingverursacht Ruckeln. Verwenden Sie stattdessentransform: scale/translate. -
Feder > lineare Beschleunigung – Natürliche Bewegung verwendet physikbasierte Beschleunigung, nicht gleichmäßige Geschwindigkeit. Federanimationen fühlen sich lebendig an.
linearfühlt sich roboterhaft an. Verwenden Sieease-outfür Eintritte,ease-infür Austritte, Feder/Bounce für interaktive Elemente, die auf Benutzereingaben reagieren. -
60fps oder nichts – Wenn eine Animation Frames fallen lässt, entfernen Sie sie. Eine ruckelige Animation ist schlechter als keine Animation. Testen Sie auf einer gedrosselten CPU (4-fache Verlangsamung in Chrome DevTools). Wenn sie unter 60fps fällt, vereinfachen oder entfernen Sie sie.
Kernkonzepte
Animationseigenschaften
- Dauer: 100-150ms für Mikro (Button Hover), 200-300ms für UI (Modal, Dropdown), 300-500ms für Layout (Seitenübergänge). Niemals über 500ms für interaktives Feedback.
- Beschleunigung:
ease-out(schneller Start, sanfte Landung) für Elemente, die in den Bildschirm eintreten.ease-in(langsamer Start, schnelles Ende) für Elemente, die den Bildschirm verlassen.ease-in-outfür Elemente, die sich über den Bildschirm bewegen. Feder für interaktive/verspielte Elemente. - Verzögerung: Sparsam verwenden. Gestaffelte Kinder maximal 50-75ms. Die gesamte Staffelsequenz sollte 400ms nicht überschreiten, sonst haben Benutzer das Gefühl zu warten.
CSS vs. JS-Animationen – Entscheidungshilfe
- Verwenden Sie CSS-Übergänge für einfache Zustandsänderungen, die durch Klasse oder Pseudoklasse (Hover, Fokus, Aktiv) ausgelöst werden. Null JS-Overhead.
- Verwenden Sie CSS-Keyframes für Schleifenanimationen (Spinner, Pulse) und choreografierte Sequenzen, die nicht an Interaktion gebunden sind.
- Verwenden Sie Framer Motion (React) für Ein-/Ausgangsanimationen, die an das Montieren/Demontieren von Komponenten gebunden sind, gestengetriebene Bewegung oder Layout-Animationen.
- Verwenden Sie GSAP für komplexe mehrstufige Zeitachsen, SVG-Pfad-Animationen, scrollausgelöste Sequenzen oder wenn Sie präzise programmatische Kontrolle benötigen.
Federphysik
Eine Feder hat zwei Schlüsselparameter: stiffness (wie schnell sie beschleunigt) und damping (wie schnell sie zur Ruhe kommt). Hohe Steifigkeit + hohe Dämpfung = schnell. Niedrige Steifigkeit + niedrige Dämpfung = hüpfend und langsam. Für UI: Steifigkeit 300-500, Dämpfung 25-35 ergibt ein natürliches Gefühl ohne übermäßiges Hüpfen.
Leistung – Compositor vs. Main Thread
Der Browser rendert in zwei Phasen: Main Thread (Layout, Paint) und Compositor Thread (Transformation, Deckkraft). Animationen auf dem Compositor-Thread laufen mit 60fps, selbst wenn der Main Thread ausgelastet ist. Verwenden Sie immer transform und opacity. Fügen Sie will-change: transform nur für Elemente hinzu, die Sie animieren werden – übermäßige Verwendung von will-change verschwendet GPU-Speicher.
Häufige Aufgaben
CSS-Übergänge und Keyframes
/* Wiederverwendbare Beschleunigungs-Token */
:root {
--ease-out: cubic-bezier(0, 0, 0.2, 1);
--ease-in: cubic-bezier(0.4, 0, 1, 1);
--ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
--ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
--duration-fast: 100ms;
--duration-normal: 200ms;
--duration-slow: 300ms;
}
/* Einblenden nach oben – erscheinender Inhalt */
@keyframes fade-in-up {
from { opacity: 0; transform: translateY(12px); }
to { opacity: 1; transform: translateY(0); }
}
/* Einzoomen – Modals, Popovers */
@keyframes scale-in {
from { opacity: 0; transform: scale(0.95); }
to { opacity: 1; transform: scale(1); }
}
.modal {
animation: scale-in var(--duration-normal) var(--ease-out);
}
/* Karten-Hover – Hebeeffekt */
.card {
transition: transform var(--duration-fast) var(--ease-out),
box-shadow var(--duration-fast) var(--ease-out);
}
.card:hover {
transform: translateY(-2px);
box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
}
Framer Motion Ein-/Ausgangsanimationen
import { motion, AnimatePresence } from 'framer-motion';
// Wiederverwendbare Animationsvarianten
const fadeUp = {
initial: { opacity: 0, y: 12 },
animate: { opacity: 1, y: 0 },
exit: { opacity: 0, y: -8 },
transition: { duration: 0.2, ease: [0, 0, 0.2, 1] },
};
const scaleIn = {
initial: { opacity: 0, scale: 0.95 },
animate: { opacity: 1, scale: 1 },
exit: { opacity: 0, scale: 0.95 },
transition: { duration: 0.15, ease: [0, 0, 0.2, 1] },
};
// Komponente mit Ein-/Ausgang
function Notification({ show, message }: { show: boolean; message: string }) {
return (
<AnimatePresence>
{show && (
<motion.div
key="notification"
{...fadeUp}
className="toast"
>
{message}
</motion.div>
)}
</AnimatePresence>
);
}
// Gestaffelte Liste
function AnimatedList({ items }: { items: string[] }) {
return (
<motion.ul
initial="hidden"
animate="visible"
variants={{
hidden: {},
visible: { transition: { staggerChildren: 0.06 } },
}}
>
{items.map((item) => (
<motion.li
key={item}
variants={{
hidden: { opacity: 0, x: -12 },
visible: { opacity: 1, x: 0, transition: { duration: 0.2 } },
}}
>
{item}
</motion.li>
))}
</motion.ul>
);
}
Scrollgesteuerte Animationen mit CSS
/* Native CSS Scroll-gesteuerte Animationen (Chrome 115+) */
@keyframes reveal {
from { opacity: 0; transform: translateY(20px); }
to { opacity: 1; transform: translateY(0); }
}
.scroll-reveal {
animation: reveal linear both;
animation-timeline: view();
animation-range: entry 0% entry 25%;
}
/* Fortschrittsbalken, gebunden an Seiten-Scroll */
.scroll-progress {
position: fixed;
top: 0;
left: 0;
height: 3px;
background: var(--color-primary-500);
transform-origin: left;
animation: scaleX linear;
animation-timeline: scroll(root);
}
@keyframes scaleX {
from { transform: scaleX(0); }
to { transform: scaleX(1); }
}
/* IntersectionObserver Fallback für breitere Browserunterstützung */
// IntersectionObserver – funktioniert in allen Browsern
const observer = new IntersectionObserver(
(entries) => {
entries.forEach((entry) => {
if (entry.isIntersecting) {
entry.target.classList.add('in-view');
observer.unobserve(entry.target); // einmal animieren
}
});
},
{ threshold: 0.15 }
);
document.querySelectorAll('[data-reveal]').forEach((el) => observer.observe(el));
[data-reveal] {
opacity: 0;
transform: translateY(16px);
transition: opacity 0.3s var(--ease-out), transform 0.3s var(--ease-out);
}
[data-reveal].in-view {
opacity: 1;
transform: translateY(0);
}
Seitenübergänge mit AnimatePresence
import { AnimatePresence, motion } from 'framer-motion';
import { usePathname } from 'next/navigation';
const pageVariants = {
initial: { opacity: 0, y: 8 },
animate: { opacity: 1, y: 0, transition: { duration: 0.25, ease: [0, 0, 0.2, 1] } },
exit: { opacity: 0, y: -8, transition: { duration: 0.15, ease: [0.4, 0, 1, 1] } },
};
export function PageTransition({ children }: { children: React.ReactNode }) {
const pathname = usePathname();
return (
<AnimatePresence mode="wait">
<motion.div key={pathname} {...pageVariants}>
{children}
</motion.div>
</AnimatePresence>
);
}
Verwenden Sie
mode="wait", damit die verlassende Seite vollständig ausanimiert, bevor die neue eintritt.mode="sync"(Standard) kann Überlappungen verursachen. Halten Sie Seitenübergänge unter 250ms – Benutzer warten darauf, neue Inhalte zu sehen.
Mikrointeraktionen – Hover, Drücken, Umschalten
import { motion } from 'framer-motion';
// Button mit Drück-Feedback
function Button({ children, onClick }: React.ComponentProps<'button'>) {
return (
<motion.button
whileHover={{ scale: 1.02 }}
whileTap={{ scale: 0.97 }}
transition={{ type: 'spring', stiffness: 500, damping: 30 }}
onClick={onClick}
>
{children}
</motion.button>
);
}
// Animierter Umschalter (CSS)
.toggle {
position: relative;
width: 44px;
height: 24px;
background: var(--color-gray-300);
border-radius: 12px;
transition: background 150ms var(--ease-in-out);
cursor: pointer;
}
.toggle[aria-checked="true"] {
background: var(--color-primary-500);
}
.toggle::after {
content: '';
position: absolute;
top: 2px;
left: 2px;
width: 20px;
height: 20px;
border-radius: 50%;
background: white;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.2);
transition: transform 200ms var(--ease-spring);
}
.toggle[aria-checked="true"]::after {
transform: translateX(20px);
}
/* Akkordeon mit grid-template-rows Trick */
.accordion-content {
display: grid;
grid-template-rows: 0fr;
transition: grid-template-rows 200ms var(--ease-out);
}
.accordion-content[data-open="true"] {
grid-template-rows: 1fr;
}
.accordion-content > div {
overflow: hidden;
}
GSAP-Zeitachse für komplexe Sequenzen
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);
// Hero-Eintrittssequenz
function animateHero() {
const tl = gsap.timeline({ defaults: { ease: 'power2.out' } });
tl.from('.hero-badge', { opacity: 0, y: 16, duration: 0.4 })
.from('.hero-headline', { opacity: 0, y: 20, duration: 0.5 }, '-=0.2')
.from('.hero-subtext', { opacity: 0, y: 16, duration: 0.4 }, '-=0.3')
.from('.hero-cta', { opacity: 0, scale: 0.95, duration: 0.35 }, '-=0.2');
return tl;
}
// Scroll-ausgelöste Feature-Karten
gsap.utils.toArray<HTMLElement>('.feature-card').forEach((card, i) => {
gsap.from(card, {
opacity: 0,
y: 32,
duration: 0.5,
delay: i * 0.08,
ease: 'power2.out',
scrollTrigger: {
trigger: card,
start: 'top 85%',
once: true,
},
});
});
Der Offset
'-=0.2'in GSAP-Zeitachsen erzeugt Überlappungen zwischen den Schritten für eine flüssige, zusammenhängende Sequenz. Ohne ihn fühlt sich jeder Schritt getrennt an. Überlappen Sie 20-40 % der Dauer des vorherigen Schritts.
prefers-reduced-motion respektieren
/* CSS – generelle Regel als Sicherheitsnetz */
@media (prefers-reduced-motion: reduce) {
*,
*::before,
*::after {
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.01ms !important;
scroll-behavior: auto !important;
}
}
// Framer Motion – useReducedMotion Hook
import { useReducedMotion } from 'framer-motion';
function AnimatedCard({ children }: { children: React.ReactNode }) {
const prefersReduced = useReducedMotion();
return (
<motion.div
initial={prefersReduced ? false : { opacity: 0, y: 12 }}
animate={{ opacity: 1, y: 0 }}
transition={prefersReduced ? { duration: 0 } : { duration: 0.2 }}
>
{children}
</motion.div>
);
}
// Vanilla JS – Präferenz vor dem Ausführen von GSAP prüfen
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (!prefersReduced) {
animateHero();
}
Anti-Patterns
| Fehler | Warum er falsch ist | Was stattdessen zu tun ist |
|---|---|---|
width, height, top oder left animieren | Löst bei jedem Frame eine Neuberechnung des Layouts aus, verursacht Ruckeln | Verwenden Sie stattdessen transform: scale() oder transform: translate() |
transition: all | Erfasst unerwartete Eigenschaften, schwer vorhersehbar, Leistungsrisiko | Listen Sie spezifische Eigenschaften auf: transition: transform 200ms, opacity 200ms |
| Dauer über 500ms für interaktives Feedback | Benutzer haben das Gefühl, die UI hinkt oder ist kaputt | Halten Sie Button/Hover/Umschalten unter 200ms, Modal unter 300ms |
| GSAP für einfache Hover-Effekte verwenden | Massiver Overhead für etwas, das CSS nativ handhabt | Verwenden Sie CSS transition für Zustandsänderungen, GSAP nur für Zeitachsen |
| Staffelverzögerung insgesamt über 500ms | Benutzer warten auf Inhalte, anstatt sie erscheinen zu sehen | Begrenzen Sie die Verzögerung pro Element auf 75ms, die gesamte Staffelung auf 400ms |
will-change: transform auf allem | Jedes will-change erzeugt eine GPU-Ebene – übermäßige Nutzung verschwendet VRAM | Nur zu Elementen hinzufügen, von denen Sie wissen, dass sie animieren werden, nach der Animation entfernen |
Referenzen
Eine detaillierte Anleitung zu bestimmten Motion-Themen finden Sie in der entsprechenden Datei
im Ordner references/:
- Animation principles →
references/animation-principles.md - Framer Motion patterns →
references/framer-motion-patterns.md - GSAP patterns →
references/gsap-patterns.md - CSS transitions and keyframes →
references/css-animations.md - Scroll-driven animations →
references/scroll-animations.md - Micro-interactions →
references/micro-interactions.md - Performance →
references/performance.md - Accessibility →
references/accessibility.md