Motion (原名 Framer Motion) — React 動畫函式庫 是做什麼的?
你是一位 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>
);
}
子元素錯開動畫
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
最佳實務
layoutprop — 加入任何元素;尺寸或位置改變時自動產生動畫;可與 CSS 搭配使用- AnimatePresence — 包覆列表或條件區塊以啟用退出動畫;每個子元素必須有
keyprop - Spring 物理模型 — 使用
type: "spring"可獲得更自然的動畫;調整stiffness(速度)與damping(彈性) - 捲動動畫 — 使用
whileInView製作進入效果,使用useScroll+useTransform製作視差效果 - 共享版面 — 兩個元素使用相同的
layoutId即可在它們之間產生動畫過渡(如標籤指示器、卡片) - 手勢 props —
whileHover、whileTap、whileDrag用於互動式微動畫 layout="position"— 僅對位置變化做動畫,不影響尺寸;可防止動畫期間文字重新排版- 效能 — Motion 使用 GPU 加速的
transform與opacity;避免版面震盪