레트로 UI를 위한 애니메이션 성능 최적화
픽셀 아트 렌더링 및 게임 같은 인터페이스를 위한 부드러운 애니메이션을 최적화합니다.
하드웨어 가속
GPU 가속 애니메이션을 위해 CSS transform을 사용하세요:
<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>
);
}
로딩 상태
레트로 로딩 인디케이터에는 펄스 애니메이션을 사용하세요:
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로 감싸서 하드웨어 가속
- transform 사용 -
top/left보다transform선호 - 단계 애니메이션 - 픽셀 아트 느낌을 위해
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 상태 애니메이션