使用 Motion 實作動畫
所有動畫工作皆使用 Motion 函式庫 (https://motion.dev)。
快速入門
React (主要):
import { motion } from "motion/react"
// 基本動畫
<motion.div animate={{ opacity: 1, y: 0 }} />
// 含轉場設定
<motion.div
animate={{ x: 100 }}
transition={{ type: "spring", stiffness: 100 }}
/>
核心模式
1. 彈簧物理 (首選)
<motion.div
animate={{ scale: 1 }}
transition={{
type: 'spring',
stiffness: 260,
damping: 20,
}}
/>
彈簧預設值:
- 柔和:
stiffness: 120, damping: 14 - 彈性:
stiffness: 180, damping: 12 - 剛硬:
stiffness: 300, damping: 20
2. 手勢互動
<motion.div
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
drag="x"
dragConstraints={{ left: -100, right: 100 }}
/>
3. 佈局動畫
<motion.div layout>{/* 內容會改變位置/大小 */}</motion.div>
4. 捲動連結效果
import { useScroll, useTransform } from "motion/react"
const { scrollYProgress } = useScroll()
const opacity = useTransform(scrollYProgress, [0, 1], [1, 0])
<motion.div style={{ opacity }} />
5. 子元素錯開出現
<motion.ul
variants={{
visible: { transition: { staggerChildren: 0.07 } },
}}
>
{items.map((item) => (
<motion.li
key={item}
variants={{
hidden: { opacity: 0, y: 20 },
visible: { opacity: 1, y: 0 },
}}
/>
))}
</motion.ul>
6. 進/出場動畫
import { AnimatePresence } from 'motion/react';
<AnimatePresence>
{show && <motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} exit={{ opacity: 0 }} />}
</AnimatePresence>;
動畫屬性
變形 (GPU 加速,高效能):
x, y, z- 平移scale, scaleX, scaleY- 縮放rotate, rotateX, rotateY, rotateZ- 旋轉skew, skewX, skewY- 傾斜
視覺 (謹慎使用,可能影響效能):
opacitybackground, backgroundColorcolorborderRadius
SVG 專用:
pathLength- 用於路徑繪製動畫pathOffset- 路徑偏移pathSpacing- 虛線間距
可存取性
始終尊重使用者偏好:
<motion.div
animate={{ x: 100 }}
transition={{
type: 'spring',
// 如果使用者偏好減少動畫,則停用動畫
duration: 0,
}}
/>
Motion 會自動處理 prefers-reduced-motion。彈簧動畫會變成瞬間轉場。
效能提示
- 盡可能只對變形/不透明度做動畫 (GPU 加速)
- 使用
layout屬性,而非手動對寬度/高度做動畫 - 避免在捲動時做動畫
- 對複雜動畫使用
will-change: transform(Motion 會自動處理) - 限制同時進行的動畫數量 - 使用錯開而非全部同時
設計原則 (簡要)
何時使用動畫
- 狀態轉換 (載入中 → 成功)
- 空間變化 (進入/離開視野)
- 吸引注意 (謹慎使用)
- 確認使用者操作
何時不使用動畫
- 重複操作首次發生後
- 對效能要求高的路徑
- 使用者控制的捲動
- 每一次互動 (節制很重要)
時間指南
- 微互動: 150-250ms
- 面板/模態轉場: 200-300ms
- 頁面轉場: 300-500ms
- 彈簧: 讓物理決定持續時間
彈簧 vs 持續時間
- 對以下情況使用彈簧: 互動元素、手勢、佈局變化
- 對以下情況使用持續時間: 有意的序列、編排、載入器
詳細動畫原則請參閱 principles.md。
常見模式
載入狀態:
<motion.div
animate={{ rotate: 360 }}
transition={{
repeat: Infinity,
duration: 1,
ease: 'linear',
}}
/>
提示通知:
<motion.div
initial={{ x: 400, opacity: 0 }}
animate={{ x: 0, opacity: 1 }}
exit={{ x: 400, opacity: 0 }}
transition={{ type: 'spring', stiffness: 300, damping: 30 }}
/>
抽屜:
<motion.div
initial={{ x: '-100%' }}
animate={{ x: 0 }}
exit={{ x: '-100%' }}
transition={{ type: 'spring', damping: 25 }}
/>
手風琴:
<motion.div
animate={{ height: isOpen ? 'auto' : 0 }}
transition={{ type: 'spring', bounce: 0 }}
style={{ overflow: 'hidden' }}
/>
資源
- Motion 文件: https://motion.dev/docs/react
- Motion 範例: https://motion.dev/examples (超過 100 個免費範例)
- GitHub 儲存庫: https://github.com/motiondivision/motion
- 延伸資源: 請參閱
resources.md以取得精選的 animation.dev 課程和知識庫
快速除錯
動畫未執行?
- 檢查元素是否為條件式渲染 (使用 AnimatePresence)
- 確認目標值與初始值不同
- 檢查是否有 CSS 覆蓋 (例如
!important)
效能問題?
- 只使用變形和不透明度
- 使用
layout屬性代替對尺寸做動畫 - 檢查瀏覽器 DevTools 的「效能」分頁
佈局動畫閃爍?
- 確保父容器有
position: relative - 必要時同時為父容器和子容器加上
layout - 檢查是否有衝突的 CSS 轉場
備註
- Motion 採用 MIT 授權,已準備好應用於生產環境
- 混合引擎:120fps,GPU 加速
- 內建 TypeScript 支援
- 可進行 Tree-shaking 以達到最佳套件大小
- 相容 React 18+ (包含 Suspense)