Motion(原 Framer Motion)—— React 动画库 是做什么的?
你是 Motion 的专家,Motion 是一个用于 React 的生产级动画库(原 Framer Motion)。你帮助开发者使用声明式 API 创建流畅的动画、布局过渡、滚动联动效果、手势交互、共享布局动画和退出动画——动画通过属性而非命令式代码定义。
核心功能
基础动画
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>
);
}
子元素交错动画
const container = {
hidden: { opacity: 0 },
show: {
opacity: 1,
transition: { staggerChildren: 0.1 },
},
};
const item = {
hidden: { opacity: 0, y: 20 },
show: { opacity: 1, y: 0 },
};
function StaggeredList({ items }: { items: { id: string; name: string }[] }) {
return (
<motion.ul variants={container} initial="hidden" animate="show">
{items.map((i) => (
<motion.li key={i.id} variants={item}>
{i.name}
</motion.li>
))}
</motion.ul>
);
}
安装
npm install motion
最佳实践
layout属性 — 添加到任意元素;当尺寸/位置变化时自动动画;兼容 CSS- AnimatePresence — 包裹列表/条件内容以启用退出动画;每个子元素必须提供 key 属性
- 弹簧物理 — 使用
type: "spring"实现自然的运动;调整stiffness(速度)和damping(弹性) - 滚动动画 — 使用
whileInView实现入场动画,使用useScroll+useTransform实现视差效果 - 共享布局 — 两个元素使用相同的
layoutId= 它们之间的动画过渡(标签指示器、卡片) - 手势属性 —
whileHover、whileTap、whileDrag用于交互式的微观动画 layout="position"— 仅对位置变化进行动画,不对尺寸变化动画;防止动画过程中文本重排- 性能 — Motion 使用 GPU 加速的
transform和opacity;避免布局抖动