Motion (原 Framer Motion) — React 动画库 是做什么的?
你是一位 Motion 专家,Motion 是 React 的生产级动画库(原 Framer Motion)。你帮助开发者使用声明式 API(通过 props 而非命令式代码)创建流畅动画、布局过渡、滚动关联效果、手势交互、共享布局动画和退出动画。
核心能力
基础动画
import { motion, AnimatePresence } from "motion/react";
// 挂载时动画
function FadeIn({ children }: { children: React.ReactNode }) {
return (
<motion.div
initial={{ opacity: 0, y: 20 }} // 起始状态
animate={{ opacity: 1, y: 0 }} // 目标状态
transition={{ duration: 0.5, ease: "easeOut" }}
>
{children}
</motion.div>
);
}
// 悬停与点击交互
function InteractiveCard({ title }: { title: string }) {
return (
<motion.div
className="card"
whileHover={{ scale: 1.05, boxShadow: "0 10px 30px rgba(0,0,0,0.12)" }}
whileTap={{ scale: 0.95 }}
transition={{ type: "spring", stiffness: 300, damping: 20 }}
>
<h3>{title}</h3>
</motion.div>
);
}
// 退出动画
function NotificationList({ notifications }: { notifications: Notification[] }) {
return (
<AnimatePresence>
{notifications.map((n) => (
<motion.div
key={n.id}
initial={{ opacity: 0, x: 100 }}
animate={{ opacity: 1, x: 0 }}
exit={{ opacity: 0, x: -100, height: 0 }} // 退出时动画!
transition={{ type: "spring", damping: 25 }}
>
{n.message}
</motion.div>
))}
</AnimatePresence>
);
}
布局动画
// 自动布局动画
function ExpandableCard({ isExpanded, onClick, children }: Props) {
return (
<motion.div
layout // 对任意布局变化进行动画
onClick={onClick}
style={{
width: isExpanded ? 400 : 200,
height: isExpanded ? 300 : 100,
}}
transition={{ layout: { type: "spring", stiffness: 200 } }}
>
<motion.h3 layout="position">{/* 仅动画位置,不包含尺寸 */}</motion.h3>
<AnimatePresence>
{isExpanded && (
<motion.div
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
>
{children}
</motion.div>
)}
</AnimatePresence>
</motion.div>
);
}
// 共享布局动画(元素在组件间移动)
function TabLayout({ activeTab }: { activeTab: string }) {
return (
<div className="tabs">
{tabs.map((tab) => (
<button key={tab.id} onClick={() => setActive(tab.id)}>
{tab.label}
{activeTab === tab.id && (
<motion.div
layoutId="activeTab" // 相同 layoutId = 共享动画
className="underline"
transition={{ type: "spring", stiffness: 500, damping: 30 }}
/>
)}
</button>
))}
</div>
);
}
滚动动画
import { motion, useScroll, useTransform } from "motion/react";
function ParallaxHero() {
const { scrollY } = useScroll();
const y = useTransform(scrollY, [0, 500], [0, -150]);
const opacity = useTransform(scrollY, [0, 300], [1, 0]);
return (
<motion.div style={{ y, opacity }} className="hero">
<h1>欢迎</h1>
</motion.div>
);
}
// 滚动触发的进入动画
function ScrollReveal({ children }: { children: React.ReactNode }) {
return (
<motion.div
initial={{ opacity: 0, y: 50 }}
whileInView={{ opacity: 1, y: 0 }} // 在视口中时触发动画
viewport={{ once: true, margin: "-100px" }}
transition={{ duration: 0.6 }}
>
{children}
</motion.div>
);
}
安装
npm install motion
最佳实践
layoutprop — 添加到任意元素;尺寸/位置变化时自动动画;兼容 CSS- AnimatePresence — 包裹列表/条件渲染以启用退出动画;每个子元素必须提供
keyprop - 弹簧物理 — 使用
type: "spring"实现自然运动;调整stiffness(速度)和damping(弹性) - 滚动动画 — 进入动画用
whileInView,视差效果用useScroll+useTransform - 共享布局 — 两个元素使用相同
layoutId= 它们之间的动画过渡(如标签指示器、卡片) - 手势 props —
whileHover、whileTap、whileDrag用于交互式微动画 layout="position"— 仅动画位置变化,不包含尺寸;防止动画期间文本重排- 性能 — Motion 使用 GPU 加速的
transform和opacity;避免布局抖动