애니메이션 & 모션 디자인은(는) 무엇을 하나요?
사용자 경험을 향상시키는 부드럽고 목적 있는 애니메이션을 만듭니다.
지침
- 목적을 가지고 애니메이션 적용 - 움직임은 안내해야 하며, 방해해서는 안 됩니다.
- 빠르게 유지 - 대부분의 UI 애니메이션은 150-300ms여야 합니다.
- 이징 곡선 사용 - UI에는 선형(linear) 타이밍을 절대 사용하지 마세요.
- 사용자 환경 설정 존중 -
prefers-reduced-motion을 준수하세요. - 성능 최적화 -
transform과opacity만 애니메이션 처리하세요.
Framer Motion (권장)
설정
npm install framer-motion
기본 애니메이션
import { motion } from 'framer-motion';
// 마운트 시 페이드인
function FadeIn({ children }: { children: React.ReactNode }) {
return (
<motion.div
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
transition={{ duration: 0.3 }}
>
{children}
</motion.div>
);
}
// 마운트 시 슬라이드업
function SlideUp({ children }: { children: React.ReactNode }) {
return (
<motion.div
initial={{ opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
transition={{ duration: 0.4, ease: 'easeOut' }}
>
{children}
</motion.div>
);
}
// 호버 시 크기 조절
function ScaleButton({ children }: { children: React.ReactNode }) {
return (
<motion.button
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
transition={{ type: 'spring', stiffness: 400, damping: 17 }}
>
{children}
</motion.button>
);
}
등장/퇴장 애니메이션
import { motion, AnimatePresence } from 'framer-motion';
function Modal({ isOpen, onClose, children }: ModalProps) {
return (
<AnimatePresence>
{isOpen && (
<>
{/* 배경 */}
<motion.div
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
transition={{ duration: 0.2 }}
className="fixed inset-0 bg-black/50"
onClick={onClose}
/>
{/* 모달 */}
<motion.div
initial={{ opacity: 0, scale: 0.95, y: 20 }}
animate={{ opacity: 1, scale: 1, y: 0 }}
exit={{ opacity: 0, scale: 0.95, y: 20 }}
transition={{ duration: 0.2, ease: 'easeOut' }}
className="fixed inset-0 flex items-center justify-center p-4"
>
<div className="bg-white rounded-xl shadow-xl max-w-md w-full p-6">
{children}
</div>
</motion.div>
</>
)}
</AnimatePresence>
);
}
리스트 애니메이션
import { motion, AnimatePresence } from 'framer-motion';
const container = {
hidden: { opacity: 0 },
show: {
opacity: 1,
transition: {
staggerChildren: 0.1,
},
},
};
const item = {
hidden: { opacity: 0, y: 20 },
show: { opacity: 1, y: 0 },
};
function AnimatedList({ items }: { items: Item[] }) {
return (
<motion.ul variants={container} initial="hidden" animate="show">
<AnimatePresence mode="popLayout">
{items.map((item) => (
<motion.li
key={item.id}
variants={item}
exit={{ opacity: 0, x: -100 }}
layout
>
<ItemCard {...item} />
</motion.li>
))}
</AnimatePresence>
</motion.ul>
);
}
레이아웃 애니메이션
import { motion, LayoutGroup } from 'framer-motion';
function ExpandableCard({ id, title, content, isExpanded, onToggle }: Props) {
return (
<LayoutGroup>
<motion.div
layout
onClick={onToggle}
className="bg-white rounded-xl p-4 cursor-pointer"
>
<motion.h3 layout="position" className="font-semibold">
{title}
</motion.h3>
<AnimatePresence>
{isExpanded && (
<motion.div
initial={{ opacity: 0, height: 0 }}
animate={{ opacity: 1, height: 'auto' }}
exit={{ opacity: 0, height: 0 }}
transition={{ duration: 0.3 }}
>
<p className="mt-4 text-gray-600">{content}</p>
</motion.div>
)}
</AnimatePresence>
</motion.div>
</LayoutGroup>
);
}
스크롤 애니메이션
import { motion, useScroll, useTransform } from 'framer-motion';
function ParallaxHero() {
const { scrollY } = useScroll();
// 패럴랙스 효과 - 이미지가 스크롤보다 느리게 움직임
const y = useTransform(scrollY, [0, 500], [0, 150]);
const opacity = useTransform(scrollY, [0, 300], [1, 0]);
return (
<div className="relative h-screen overflow-hidden">
<motion.div
style={{ y }}
className="absolute inset-0"
>
<img src="/hero.jpg" className="w-full h-full object-cover" />
</motion.div>
<motion.div
style={{ opacity }}
className="relative z-10 flex items-center justify-center h-full"
>
<h1 className="text-6xl font-bold text-white">환영합니다</h1>
</motion.div>
</div>
);
}
// 스크롤 시 나타나기
function ScrollReveal({ children }: { children: React.ReactNode }) {
return (
<motion.div
initial={{ opacity: 0, y: 50 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, margin: '-100px' }}
transition={{ duration: 0.6, ease: 'easeOut' }}
>
{children}
</motion.div>
);
}
제스처 애니메이션
import { motion, useDragControls } from 'framer-motion';
function DraggableCard() {
return (
<motion.div
drag
dragConstraints={{ left: -100, right: 100, top: -100, bottom: 100 }}
dragElastic={0.1}
whileDrag={{ scale: 1.05, cursor: 'grabbing' }}
className="w-48 h-48 bg-blue-500 rounded-xl cursor-grab"
/>
);
}
function SwipeToDelete({ onDelete }: { onDelete: () => void }) {
return (
<motion.div
drag="x"
dragConstraints={{ left: 0, right: 0 }}
onDragEnd={(_, info) => {
if (info.offset.x < -100) {
onDelete();
}
}}
className="bg-white p-4 rounded-lg"
>
왼쪽으로 밀어 삭제
</motion.div>
);
}
로딩 상태
스켈레톤 로더
function Skeleton({ className = '' }: { className?: string }) {
return (
<div
className={`animate-pulse bg-gray-200 dark:bg-gray-700 rounded ${className}`}
/>
);
}
function CardSkeleton() {
return (
<div className="bg-white rounded-xl p-6 space-y-4">
<Skeleton className="h-6 w-3/4" />
<Skeleton className="h-4 w-full" />
<Skeleton className="h-4 w-5/6" />
<div className="flex gap-4 pt-4">
<Skeleton className="h-10 w-24" />
<Skeleton className="h-10 w-24" />
</div>
</div>
);
}
스피너
function Spinner({ size = 'md' }: { size?: 'sm' | 'md' | 'lg' }) {
const sizes = {
sm: 'w-4 h-4',
md: 'w-8 h-8',
lg: 'w-12 h-12',
};
return (
<svg
className={`animate-spin text-blue-600 ${sizes[size]}`}
viewBox="0 0 24 24"
fill="none"
>
<circle
className="opacity-25"
cx="12"
cy="12"
r="10"
stroke="currentColor"
strokeWidth="4"
/>
<path
className="opacity-75"
fill="currentColor"
d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"
/>
</svg>
);
}
진행률 표시줄
function ProgressBar({ value, max = 100 }: { value: number; max?: number }) {
const percentage = Math.min((value / max) * 100, 100);
return (
<div className="h-2 bg-gray-200 rounded-full overflow-hidden">
<motion.div
className="h-full bg-blue-600"
initial={{ width: 0 }}
animate={{ width: `${percentage}%` }}
transition={{ duration: 0.5, ease: 'easeOut' }}
/>
</div>
);
}
CSS 애니메이션
Tailwind 애니메이션
// 내장 Tailwind 애니메이션
<div className="animate-spin">스피너</div>
<div className="animate-ping">핑</div>
<div className="animate-pulse">펄스</div>
<div className="animate-bounce">바운스</div>
// tailwind.config.js의 사용자 정의 애니메이션
module.exports = {
theme: {
extend: {
animation: {
'fade-in': 'fadeIn 0.3s ease-out',
'slide-up': 'slideUp 0.4s ease-out',
'scale-in': 'scaleIn 0.2s ease-out',
},
keyframes: {
fadeIn: {
'0%': { opacity: '0' },
'100%': { opacity: '1' },
},
slideUp: {
'0%': { transform: 'translateY(20px)', opacity: '0' },
'100%': { transform: 'translateY(0)', opacity: '1' },
},
scaleIn: {
'0%': { transform: 'scale(0.95)', opacity: '0' },
'100%': { transform: 'scale(1)', opacity: '1' },
},
},
},
},
};
CSS 전환
<button className="
bg-blue-600 text-white px-4 py-2 rounded-lg
transition-all duration-200 ease-out
hover:bg-blue-700 hover:shadow-lg hover:-translate-y-0.5
active:translate-y-0 active:shadow-md
">
호버해보세요
</button>
사용자 환경 설정 존중
import { useReducedMotion } from 'framer-motion';
function AnimatedComponent() {
const shouldReduceMotion = useReducedMotion();
return (
<motion.div
initial={shouldReduceMotion ? false : { opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
transition={shouldReduceMotion ? { duration: 0 } : { duration: 0.4 }}
>
콘텐츠
</motion.div>
);
}
// CSS 접근법
@media (prefers-reduced-motion: reduce) {
*,
*::before,
*::after {
animation-duration: 0.01ms !important;
transition-duration: 0.01ms !important;
}
}
성능 팁
- transform과 opacity만 애니메이션 처리 - GPU 가속
will-change는 드물게 사용 - 복잡한 애니메이션에만- 레이아웃 스래싱 방지 - width/height를 애니메이션하지 마세요
layoutprop은 신중하게 사용 - 리플로우 발생 가능- 스크롤 핸들러 디바운스 - 버벅거림 방지
// 좋음 - GPU 가속
<motion.div animate={{ x: 100, opacity: 0.5 }} />
// 나쁨 - 리플로우 발생
<motion.div animate={{ width: 200, marginLeft: 100 }} />
사용 시점
- 페이지 전환 및 탐색
- 로딩 및 스켈레톤 상태
- 인터랙티브 UI 요소
- 피드백 및 확인
- 온보딩 및 튜토리얼
- 데이터 시각화 전환
참고 사항
- Framer Motion은 약 30kb를 번들에 추가합니다 (gzip 압축 기준)
- 간단한 호버/포커스 전환에는 CSS 사용
- 애니메이션을 0.25배속으로 테스트하여 부드러움 확인
- 멀미 고려 - 과도한 움직임 피하기
