復古 UI 的動畫效能
優化動畫以實現流暢的像素藝術渲染和類似遊戲的介面。
硬體加速
使用 CSS transforms 進行 GPU 加速動畫:
<div className="transition-transform hover:scale-110" />
<div className="translate-x-0 translate-y-0" />
避免對以下屬性進行動畫:
width、height(觸發佈局)margin、padding(觸發佈局)top、left(觸發佈局)
偏好對以下屬性進行動畫:
transform(GPU 加速)opacity(GPU 加速)filter(GPU 加速)
像素風格動畫
將動畫 SVG 包裹在 div 中以實現硬體加速:
function PixelSpinner() {
return (
<div className="animate-spin">
<svg viewBox="0 0 16 16">
<rect x="2" y="2" width="4" height="4" fill="currentColor" />
</svg>
</div>
);
}
載入狀態
使用 pulse 動畫作為復古風格的載入指示器:
function RetroSkeleton() {
return (
<div className="relative animate-pulse">
<div className="h-20 bg-muted" />
</div>
);
}
自訂復古動畫
定義像素藝術專用的動畫:
<div
className="retro animate-[blink_0.5s_step-end_infinite]"
style={{
textShadow: "1px 1px 0 #fff, -1px -1px 0 #fff, 1px -1px 0 #fff, -1px 1px 0 #fff"
}}
>
LEVEL UP!
</div>
<style>{`
@keyframes blink {
0%, 100% { opacity: 1; }
50% { opacity: 0; }
}
`}</style>
條件式動畫狀態
根據遊戲狀態套用動畫:
<div
className={cn(
"transition-all duration-300",
health <= 25 && "animate-pulse bg-red-500/20",
isLevelUp && "animate-bounce"
)}
/>
Radix UI 動畫
對覆蓋層使用基於 Radix 狀態的動畫:
<DialogContent
className={cn(
"data-[state=open]:animate-in data-[state=closed]:animate-out",
"data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0",
"data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95"
)}
/>
<AccordionContent
className={cn(
"overflow-hidden data-[state=closed]:animate-accordion-up",
"data-[state=open]:animate-accordion-down"
)}
/>
關鍵原則
- 包裹 SVG - 始終用 div 包裹以啟用硬體加速
- 使用 transforms - 偏好
transform而非top/left - 逐格動畫 - 使用
step-end以獲得像素藝術感 - 條件式類別 - 根據遊戲狀態套用動畫
- 自訂關鍵影格 - 定義復古專屬動畫
- 文字陰影 - 使用白色陰影以在彩色背景上保持可讀性
效能檢查清單
- 動畫元素已包裹在 div 中
- 沒有對觸發佈局的屬性進行動畫
- 載入狀態使用
animate-pulse - 條件式動畫已正確設定條件
- 自訂動畫使用逐格時間函數
參考元件
components/ui/8bit/spinner.tsx- 動畫旋轉器components/ui/8bit/xp-bar.tsx- 自訂閃爍動畫components/ui/8bit/skeleton.tsx- 載入骨架components/ui/8bit/accordion.tsx- Radix 狀態動畫