使用 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-250 毫秒
- 面板/模態轉場:200-300 毫秒
- 頁面轉場:300-500 毫秒
- 彈簧:讓物理決定持續時間
彈簧 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 支援
- 可樹狀搖晃以達到最佳套件大小
- 支援 React 18+(包含 Suspense)