UI 動畫模式
兩項任務:在網頁上為真實產品 UI 添加動畫,以及在不重新設計的情況下為影片重建產品 UI。兩者使用相同的標記。
1. 先定義標記
一次性定義動畫,並在各地引入使用。元件中避免使用內聯數值。
// lib/motion-tokens.ts
export const motionTokens = {
duration: { instant: 0.1, fast: 0.18, normal: 0.3, slow: 0.5, scene: 0.7 },
easing: {
standard: [0.2, 0, 0, 1], // 進入 + 移動
exit: [0.4, 0, 1, 1], // 離開
emphasized: [0.3, 0, 0, 1],
},
distance: { nudge: 4, small: 8, medium: 16, large: 32 },
stagger: 0.06, // 保持在 0.05 到 0.10 之間
} as const;
export const springs = {
press: { type: "spring", stiffness: 600, damping: 38 }, // 按鈕、切換開關
snappy: { type: "spring", stiffness: 420, damping: 34 }, // 晶片、選單
gentle: { type: "spring", stiffness: 260, damping: 27 }, // 卡片、面板
layout: { type: "spring", stiffness: 320, damping: 30 }, // 重新排序、調整大小
camera: { type: "spring", stiffness: 140, damping: 20 }, // 大幅移動,僅用於影片
} as const;
在質量為 1 的情況下,阻尼比 ζ = damping / (2·√stiffness):press 0.78、snappy 0.83、gentle 0.84、layout 0.84、camera 0.85 — 全部落在 0.75–0.90 的區間內(超調量 ≤ ~6%)。可根據品牌需求使用該公式進行調整,並將此表作為單一來源。
2. 輔助功能與 SSR
"use client";
import { useReducedMotion } from "motion/react";
export function useSafeMotion() {
const reduce = useReducedMotion();
return {
reduce,
// 減少動畫:移除變形,保留短暫的不透明度變化(≤0.2 秒)
enter: reduce ? { opacity: 1 } : { opacity: 1, y: 0 },
initial: reduce ? { opacity: 0 } : { opacity: 0, y: 8 },
transition: reduce ? { duration: 0.2 } : undefined,
};
}
- 對於首次繪製時已可見的元素,請使用
initial={false}以避免水合閃爍。 - 僅對
transform和opacity進行動畫處理。切勿在循環中對width、height、top、left或box-shadow進行動畫處理;應改用layout或 scale。 - 低端裝置:縮短持續時間並跳過裝飾性動畫。
3. 模式及其規則
| 模式 | 規則 |
|---|---|
| 按鈕按壓 | whileTap={{ scale: 0.96 }} 搭配 springs.press;在 100 毫秒內提供回饋 |
| 條件式渲染 | 使用 AnimatePresence 包裹,並附上穩定的 key;每個 initial + animate 都需搭配一個 exit |
| 頁面/路由轉場 | AnimatePresence mode="wait":退出動畫完成後才開始進入動畫 |
| 列表交錯顯示 | staggerChildren 0.05–0.10 秒;交錯項目標上限約為 8 個,其餘項目同時出現 |
| 重新排序/調整大小 | 僅在小型子樹(≲5 個子元素)上使用 layout;否則使用明確的 x/y |
| 模態框/底部面板 | 焦點陷阱、Escape 鍵關閉、滾動鎖定、role="dialog"、aria-modal="true"、歸還焦點 |
| 提示訊息 | 從其所處的邊緣進入;自動消失,懸停或聚焦時暫停 |
| 數字變化 | 垂直滾動:舊值向上移出並模糊,新值從下方進入;使用 font-variant-numeric: tabular-nums |
| 滾動觸發顯示 | 使用 whileInView 搭配 viewport={{ once: true }};切勿在滾出後重新觸發動畫 |
| 載入 → 成功 | 按鈕壓縮 → 旋轉載入圖示 → 打勾;保持按鈕寬度穩定 |
4. 為影片重建產品 UI
- 測量,而非猜測。 從產品原始碼或計算後的樣式中取得標記:顏色、圓角、字型系列/粗細/字距、間距、圖示集和筆畫粗細。從真實螢幕截圖中取樣顏色並進行比較。
- 預設採用混合方式。 使用真實螢幕截圖作為背景;僅重建會動畫化的元素,並與其像素級對齊。
- 未經明確許可,切勿重新設計。 不使用新的顏色、字型、圖示或文案。
- 捕捉乾淨的畫面。 使用登出或示範帳號、虛構資料、不包含個資,也不包含第三方品牌(除非使用者擁有該品牌)。
- 可尋的。 在影片中,每個動畫值都應由絕對時間驅動(
value = f(t)),而非來自motion/react的執行時狀態。在實際網站上使用motion/react;對於渲染後的影片,則使用閉合形式的彈簧或 GSAP 時間軸。
當這些模式應用於網站而非影片時,請在發佈前執行 design-expert 驗證關卡(鍵盤、焦點、減少動畫、效能)。