Motion (Framer Motion) — Skill
Name: motion
Zweck: Implementieren Sie flüssige, barrierefreie Animationen mit motion/react in React.
Verwenden Sie diesen Skill, wenn Sie Animationen, Gesten oder Layout-Übergänge hinzufügen.
Anwendbar bei: Verwendung von motion/react (motion, AnimatePresence, useScroll usw.).
Nicht anwenden, wenn: Keine Animationen benötigt werden oder die Komponente strikt serverseitig gerendert wird.
Regeln
- Nur-Client-Grenze: Motion erfordert
'use client'; halten Sie Client-Insellösungen klein. - Einfach beginnen: Beginnen Sie mit Deckkraft/Verschiebung, bevor Sie Federphysik hinzufügen.
- Das richtige Werkzeug verwenden:
AnimatePresencefür Ein-/Ausblendungen,layoutfür Layout,whileHover/whileTapfür Gesten. - Reduzierte Bewegung respektieren: Verwenden Sie
useReducedMotion(). - Bundle-Disziplin: Verwenden Sie
LazyMotionfür größere Motion-Oberflächen.
Arbeitsablauf
- Identifizieren Sie den UX-Zweck (Feedback, Übergang, Fokus).
- Fügen Sie die kleinste
'use client'-Grenze hinzu. - Implementieren Sie Ein-/Ausblendungen oder Layout-Übergänge korrekt.
- Respektieren Sie Präferenzen für reduzierte Bewegung.
- Überprüfen Sie Leistung und Bundle-Größe.
Checklisten
Implementierungs-Checkliste
-
'use client'nur dort, wo es benötigt wird - Verhalten bei reduzierter Bewegung definiert
-
AnimatePresenceumschließt bedingte UI - Layout-Übergänge verwenden
layout
Review-Checkliste
- Animationen werden nicht bei jedem Rendern erneut ausgeführt
- Motion-Code erweitert den Client-Baum nicht unnötig
Minimalbeispiele
Ein-/Ausblenden
"use client";
import { AnimatePresence, motion } from "motion/react";
export function Toast({
open,
children,
}: {
open: boolean;
children: React.ReactNode;
}) {
return (
<AnimatePresence>
{open ? (
<motion.div
initial={{ opacity: 0, y: 8 }}
animate={{ opacity: 1, y: 0 }}
exit={{ opacity: 0, y: 8 }}
transition={{ duration: 0.18 }}
>
{children}
</motion.div>
) : null}
</AnimatePresence>
);
}
Layout-Animation
"use client";
import { motion } from "motion/react";
export function Expander({ open }: { open: boolean }) {
return (
<motion.div layout className="overflow-hidden rounded-md border p-3">
<div className="font-medium">Titel</div>
{open ? <div className="mt-2 text-sm">Mehr Inhalt...</div> : null}
</motion.div>
);
}
Reduzierte Bewegung
"use client";
import { motion, useReducedMotion } from "motion/react";
export function FadeIn({ children }: { children: React.ReactNode }) {
const reduce = useReducedMotion();
return (
<motion.div
initial={reduce ? false : { opacity: 0, y: 6 }}
animate={reduce ? { opacity: 1 } : { opacity: 1, y: 0 }}
transition={{ duration: 0.2 }}
>
{children}
</motion.div>
);
}
Häufige Fehler / Fallstricke
- Ausblenden ohne
AnimatePresence(Ausblend-Animationen werden nie ausgeführt) - Layout animieren ohne
layout - Motion in einen riesigen Client-Baum einfügen
- Große Listen ohne Virtualisierung animieren