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>Welcome</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
最佳實踐
layout屬性 — 加到任何元素上;當大小/位置改變時自動觸發動畫;可與 CSS 搭配使用- AnimatePresence — 包住列表/條件渲染以啟用退出動畫;每個子元素需要
key屬性 - Spring 物理 — 使用
type: "spring"實現自然運動;調整stiffness(速度)和damping(彈性) - 滾動動畫 — 使用
whileInView實現進入效果,useScroll+useTransform實現視差效果 - 共享佈局 — 兩個元素相同
layoutId= 它們之間的動畫過渡(頁籤指示器、卡片) - 手勢屬性 —
whileHover、whileTap、whileDrag用於互動微動畫 layout="position"— 僅動畫化位置變化,不改變大小;防止動畫期間文字重新排版- 效能 — Motion 使用 GPU 加速的
transform和opacity;避免佈局抖動
此技能為
ComeOnOliver/skillshub的一部分。