Was macht Animationsimplementierung mit Motion?
Verwenden Sie die Motion-Bibliothek (https://motion.dev) für alle Animationsarbeiten.
Schnellstart
React (primär):
import { motion } from "motion/react"
// Einfache Animation
<motion.div animate={{ opacity: 1, y: 0 }} />
// Mit Übergangskonfiguration
<motion.div
animate={{ x: 100 }}
transition={{ type: "spring", stiffness: 100 }}
/>
Kernmuster
1. Federphysik (bevorzugt)
<motion.div
animate={{ scale: 1 }}
transition={{
type: 'spring',
stiffness: 260,
damping: 20,
}}
/>
Feder-Voreinstellungen:
- Sanft:
stiffness: 120, damping: 14 - Schwankend:
stiffness: 180, damping: 12 - Steif:
stiffness: 300, damping: 20
2. Gesteninteraktionen
<motion.div
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
drag="x"
dragConstraints={{ left: -100, right: 100 }}
/>
3. Layoutanimationen
<motion.div layout>{/* Inhalt, der Position/Größe ändert */}</motion.div>
4. Scrollgebundene Effekte
import { useScroll, useTransform } from "motion/react"
const { scrollYProgress } = useScroll()
const opacity = useTransform(scrollYProgress, [0, 1], [1, 0])
<motion.div style={{ opacity }} />
5. Gestaffelte Kinder
<motion.ul
variants={{
visible: { transition: { staggerChildren: 0.07 } },
}}
>
{items.map((item) => (
<motion.li
key={item}
variants={{
hidden: { opacity: 0, y: 20 },
visible: { opacity: 1, y: 0 },
}}
/>
))}
</motion.ul>
6. Ein-/Ausgangsanimationen
import { AnimatePresence } from 'motion/react';
<AnimatePresence>
{show && <motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} exit={{ opacity: 0 }} />}
</AnimatePresence>;
Animationseigenschaften
Transform (GPU-beschleunigt, leistungsstark):
x, y, z- Verschiebenscale, scaleX, scaleY- Skalierenrotate, rotateX, rotateY, rotateZ- Rotationskew, skewX, skewY- Neigen
Visuell (sparsam verwenden, kann die Leistung beeinträchtigen):
opacitybackground, backgroundColorcolorborderRadius
SVG-spezifisch:
pathLength- Für PfadzeichnungsanimationenpathOffset- Versatz des PfadespathSpacing- Abstand zwischen Strichen
Zugänglichkeit
Respektieren Sie immer die Benutzereinstellungen:
<motion.div
animate={{ x: 100 }}
transition={{
type: 'spring',
// Deaktiviert Animation, wenn der Benutzer reduzierte Bewegung bevorzugt
duration: 0,
}}
/>
Motion behandelt prefers-reduced-motion automatisch. Federn werden zu sofortigen Übergängen.
Leistungstipps
- Nur Transforms/Optimität animieren wenn möglich (GPU-beschleunigt)
- Das
layout-Prop verwenden anstatt Breite/Höhe manuell zu animieren - Animation während des Scrollens vermeiden wenn möglich
will-change: transformverwenden für komplexe Animationen (Motion erledigt dies)- Gleichzeitige Animationen begrenzen - staffeln statt alles auf einmal
Gestaltungsprinzipien (kurz)
Wann animieren
- Zustandsübergänge (Laden → Erfolg)
- Räumliche Änderungen (Eintreten/Verlassen der Ansicht)
- Aufmerksamkeit lenken (sparsam)
- Benutzeraktion bestätigen
Wann NICHT animieren
- Wiederholte Aktionen nach dem ersten Vorkommen
- Leistungskritische Pfade
- Benutzergesteuertes Scrollen
- Jede einzelne Interaktion (Zurückhaltung ist wichtig)
Timing-Richtlinien
- Mikrointeraktionen: 150-250ms
- Panel-/Modal-Übergänge: 200-300ms
- Seitenübergänge: 300-500ms
- Federn: Die Physik die Dauer bestimmen lassen
Feder vs. Dauer
- Federn verwenden für: Interaktive Elemente, Gesten, Layoutänderungen
- Dauer verwenden für: Gezielte Abläufe, Choreografie, Loader
Siehe principles.md für die ausführliche Animationsphilosophie.
Häufige Muster
Ladezustand:
<motion.div
animate={{ rotate: 360 }}
transition={{
repeat: Infinity,
duration: 1,
ease: 'linear',
}}
/>
Toast-Benachrichtigung:
<motion.div
initial={{ x: 400, opacity: 0 }}
animate={{ x: 0, opacity: 1 }}
exit={{ x: 400, opacity: 0 }}
transition={{ type: 'spring', stiffness: 300, damping: 30 }}
/>
Seitenleiste:
<motion.div
initial={{ x: '-100%' }}
animate={{ x: 0 }}
exit={{ x: '-100%' }}
transition={{ type: 'spring', damping: 25 }}
/>
Akkordeon:
<motion.div
animate={{ height: isOpen ? 'auto' : 0 }}
transition={{ type: 'spring', bounce: 0 }}
style={{ overflow: 'hidden' }}
/>
Ressourcen
- Motion-Dokumentation: https://motion.dev/docs/react
- Motion-Beispiele: https://motion.dev/examples (100+ kostenlose Beispiele)
- GitHub-Repository: https://github.com/motiondivision/motion
- Erweiterte Ressourcen: Siehe
resources.mdfür kuratierte animation.dev-Lektionen und das Vault
Schnelle Fehlerbehebung
Animation läuft nicht?
- Prüfen, ob das Element bedingt gerendert wird (AnimatePresence verwenden)
- Sicherstellen, dass die Zielwerte von den Anfangswerten abweichen
- Auf CSS achten, das möglicherweise überschreibt (z. B.
!important)
Leistungsprobleme?
- Bei Transforms und Opacity bleiben
- Das
layout-Prop anstelle der Animation von Abmessungen verwenden - Den Leistungstab der Browser-Entwicklertools prüfen
Layout-Animationen flackern?
- Sicherstellen, dass das Elternelement
position: relativehat - Bei Bedarf
layoutsowohl beim Eltern- als auch beim Kindelement hinzufügen - Auf widersprüchliche CSS-Übergänge prüfen
Hinweise
- Motion ist MIT-lizenziert, produktionsreif
- Hybride Engine: 120fps, GPU-beschleunigt
- TypeScript-Support integriert
- Baumgeschüttelt für optimale Bundle-Größe
- Funktioniert mit React 18+ (einschließlich Suspense)