Motion (Framer Motion) — 技能 是做什麼的?
名稱: motion
目的: 使用 motion/react 在 React 中實現流暢、無障礙的動畫。
每當需要添加動畫、手勢或佈局過渡時使用此技能。
適用時機: 使用 motion/react(motion、AnimatePresence、useScroll 等)。
不應使用時機: 不需要動畫或組件為純服務端渲染時。
規則
- 僅限客戶端邊界: Motion 需要
'use client';保持客戶端島嶼小巧。 - 從簡開始: 在加入彈簧物理效果之前,先從透明度/位移開始。
- 使用正確的工具:
AnimatePresence用於進/出動畫,layout用於佈局動畫,whileHover/whileTap用於手勢動畫。 - 尊重減少動畫偏好: 使用
useReducedMotion()。 - 打包體積紀律: 對於較大的動畫場景,使用
LazyMotion。
工作流程
- 確定 UX 目的(反饋、過渡、焦點)。
- 添加最小的
'use client'邊界。 - 正確實現進/出或佈局過渡。
- 尊重減少動畫偏好。
- 檢查效能與打包體積。
檢查清單
實現檢查清單
- 僅在需要的地方使用
'use client' - 定義減少動畫行為
-
AnimatePresence包裹條件式 UI - 佈局過渡使用
layout
審查檢查清單
- 動畫不會在每次渲染時重新執行
- Motion 程式碼不會不必要地擴大客戶端樹
最小範例
進/出動畫
"use client";
import { AnimatePresence, motion } from "motion/react";
export function Toast({
open,
children,
}: {
open: boolean;
children: React.ReactNode;
}) {
return (
<AnimatePresence>
{open ? (
<motion.div
initial={{ opacity: 0, y: 8 }}
animate={{ opacity: 1, y: 0 }}
exit={{ opacity: 0, y: 8 }}
transition={{ duration: 0.18 }}
>
{children}
</motion.div>
) : null}
</AnimatePresence>
);
}
佈局動畫
"use client";
import { motion } from "motion/react";
export function Expander({ open }: { open: boolean }) {
return (
<motion.div layout className="overflow-hidden rounded-md border p-3">
<div className="font-medium">Title</div>
{open ? <div className="mt-2 text-sm">More content...</div> : null}
</motion.div>
);
}
減少動畫
"use client";
import { motion, useReducedMotion } from "motion/react";
export function FadeIn({ children }: { children: React.ReactNode }) {
const reduce = useReducedMotion();
return (
<motion.div
initial={reduce ? false : { opacity: 0, y: 6 }}
animate={reduce ? { opacity: 1 } : { opacity: 1, y: 0 }}
transition={{ duration: 0.2 }}
>
{children}
</motion.div>
);
}
常見錯誤 / 陷阱
- 在沒有
AnimatePresence的情況下卸載元件(離開動畫永遠不會執行) - 在沒有
layout屬性的情況下動畫佈局 - 將 Motion 放在巨大的客戶端樹中
- 在沒有虛擬化的情況下對大型列表進行動畫處理