이 스킬이 활성화되면 항상 첫 응답을 🧢 이모지로 시작하세요.
모션 디자인
웹 애플리케이션에서 애니메이션과 모션을 구현하기 위한 집중적이고 전문적인 지식 베이스입니다. CSS 전환 및 키프레임, Framer Motion, GSAP, 스크롤 기반 애니메이션, 마이크로인터랙션을 다루며 각 패턴에 대한 구체적인 코드 예제를 제공합니다. 모든 권장 사항은 60fps 성능, 접근성, 그리고 장식보다는 목적 있는 모션을 우선시합니다.
좋은 애니메이션과 나쁜 애니메이션의 차이는 절제입니다. 대부분의 UI는 더 많은 애니메이션이 아닌 더 적은 애니메이션이 필요합니다. 모션이 존재할 때는 빠르고, 부드럽고, 사용자 선호도를 존중해야 합니다.
이 스킬을 사용하는 경우
다음과 같은 경우 이 스킬을 활성화하세요:
- UI 요소에 애니메이션이나 전환을 추가하려는 경우
- 컴포넌트 마운트/언마운트에 대한 등장/퇴장 애니메이션이 필요한 경우
- 페이지 전환이나 라우트 변경 애니메이션을 구현하려는 경우
- Framer Motion, GSAP 또는 CSS 애니메이션 API에 대해 문의하는 경우
- 스크롤 기반 애니메이션이나 패럴랙스 효과가 필요한 경우
- 스켈레톤 화면이나 스피너가 포함된 로딩 상태를 원하는 경우
- 스프링 물리, 이징 커브 또는 애니메이션 타이밍에 대해 문의하는 경우
- 복잡한 다단계 시퀀스를 위한 GSAP 타임라인이 필요한 경우
- 마이크로인터랙션(호버, 프레스, 토글, 체크박스 상태)에 대해 문의하는 경우
다음과 같은 경우에는 이 스킬을 활성화하지 마세요:
- 모션이 없는 순수 CSS 레이아웃 또는 스타일링(대신
ultimate-ui사용) - Canvas 또는 WebGL 렌더링(대신 그래픽 관련 리소스 사용)
핵심 원칙
-
모션에는 목적이 있어야 합니다 - 모든 애니메이션은 상태 변화, 공간 관계, 피드백, 계층 구조 등 무언가를 전달해야 합니다. 장식 전용 모션은 잡음입니다. 애니메이션을 추가하기 전에 "이 애니메이션이 사용자에게 무엇을 알려주는가?"를 물어보세요.
-
prefers-reduced-motion을 존중하세요 - 항상prefers-reduced-motion검사로 애니메이션을 감싸세요. 전정 장애나 간질이 있는 사용자는 모션으로 인해 해를 입을 수 있습니다. 이는 제안이 아닌 WCAG 2.1 AA 요구 사항입니다. -
transform과 opacity만 애니메이션 처리하세요 -
transform과opacity는 브라우저가 레이아웃이나 페인트를 트리거하지 않고 컴포지터 스레드에서 애니메이션 처리할 수 있는 유일한 속성입니다.width,height,top,left,margin,padding을 애니메이션 처리하면 버벅거림이 발생합니다. 대신transform: scale/translate를 사용하세요. -
선형 이징보다 스프링을 사용하세요 - 자연스러운 모션은 균일한 속도가 아닌 물리 기반 이징을 사용합니다. 스프링 애니메이션은 생동감이 있습니다.
linear는 로봇처럼 느껴집니다. 등장에는ease-out, 퇴장에는ease-in, 사용자 입력에 반응하는 인터랙티브 요소에는 스프링/바운스를 사용하세요. -
60fps 아니면 없음 - 애니메이션이 프레임을 떨어뜨리면 제거하세요. 버벅거리는 애니메이션은 애니메이션이 없는 것보다 더 나쁩니다. CPU를 스로틀링한 상태(Chrome DevTools에서 4배 느리게)에서 테스트하세요. 60fps 미만으로 떨어지면 단순화하거나 잘라내세요.
핵심 개념
애니메이션 속성
- 지속 시간: 마이크로(버튼 호버)는 100-150ms, UI(모달, 드롭다운)는 200-300ms, 레이아웃(페이지 전환)은 300-500ms입니다. 인터랙티브 피드백의 경우 500ms를 초과하지 마세요.
- 이징: 화면에 들어오는 요소에는
ease-out(빠른 시작, 부드러운 착지). 화면을 떠나는 요소에는ease-in(느린 시작, 빠른 종료). 화면을 가로질러 이동하는 요소에는ease-in-out. 인터랙티브/재미있는 요소에는 스프링. - 지연: 드물게 사용하세요. 자식 요소를 최대 50-75ms 간격으로 지연시키세요. 총 지연 시퀀스는 400ms를 초과하지 않아야 합니다. 그렇지 않으면 사용자가 기다리고 있다고 느낍니다.
CSS 대 JS 애니메이션 - 결정 가이드
- CSS 전환은 클래스나 의사 클래스(호버, 포커스, 활성)로 트리거되는 단순한 상태 변경에 사용합니다. JS 오버헤드가 전혀 없습니다.
- CSS 키프레임은 반복 애니메이션(스피너, 펄스)과 인터랙션에 종속되지 않은 안무 시퀀스에 사용합니다.
- Framer Motion(React)은 컴포넌트 마운트/언마운트와 관련된 등장/퇴장 애니메이션, 제스처 기반 모션, 레이아웃 애니메이션에 사용합니다.
- GSAP은 복잡한 다단계 타임라인, SVG 경로 애니메이션, 스크롤 트리거 시퀀스, 또는 정밀한 프로그래밍 제어가 필요할 때 사용합니다.
스프링 물리
스프링에는 두 가지 주요 매개변수가 있습니다: stiffness(가속도)와 damping(진정 속도). 높은 강성 + 높은 감쇠 = 경쾌함. 낮은 강성 + 낮은 감쇠 = 탄력 있고 느림. UI의 경우: 강성 300-500, 감쇠 25-35가 과도한 바운스 없이 자연스러운 느낌을 줍니다.
성능 - 컴포지터 대 메인 스레드
브라우저는 두 단계로 렌더링합니다: 메인 스레드(레이아웃, 페인트)와 컴포지터 스레드(transform, opacity). 컴포지터 스레드의 애니메이션은 메인 스레드가 바쁠 때도 60fps로 실행됩니다. 항상 transform과 opacity를 사용하세요. 애니메이션 처리할 요소에만 will-change: transform을 추가하세요. will-change를 과도하게 사용하면 GPU 메모리가 낭비됩니다.
일반적인 작업
CSS 전환 및 키프레임
/* 재사용 가능한 이징 토큰 */
:root {
--ease-out: cubic-bezier(0, 0, 0.2, 1);
--ease-in: cubic-bezier(0.4, 0, 1, 1);
--ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
--ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
--duration-fast: 100ms;
--duration-normal: 200ms;
--duration-slow: 300ms;
}
/* 페이드 인 업 - 콘텐츠 나타남 */
@keyframes fade-in-up {
from { opacity: 0; transform: translateY(12px); }
to { opacity: 1; transform: translateY(0); }
}
/* 스케일 인 - 모달, 팝오버 */
@keyframes scale-in {
from { opacity: 0; transform: scale(0.95); }
to { opacity: 1; transform: scale(1); }
}
.modal {
animation: scale-in var(--duration-normal) var(--ease-out);
}
/* 카드 호버 - 들어올림 효과 */
.card {
transition: transform var(--duration-fast) var(--ease-out),
box-shadow var(--duration-fast) var(--ease-out);
}
.card:hover {
transform: translateY(-2px);
box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
}
Framer Motion 등장/퇴장 애니메이션
import { motion, AnimatePresence } from 'framer-motion';
// 재사용 가능한 애니메이션 변형
const fadeUp = {
initial: { opacity: 0, y: 12 },
animate: { opacity: 1, y: 0 },
exit: { opacity: 0, y: -8 },
transition: { duration: 0.2, ease: [0, 0, 0.2, 1] },
};
const scaleIn = {
initial: { opacity: 0, scale: 0.95 },
animate: { opacity: 1, scale: 1 },
exit: { opacity: 0, scale: 0.95 },
transition: { duration: 0.15, ease: [0, 0, 0.2, 1] },
};
// 등장/퇴장이 있는 컴포넌트
function Notification({ show, message }: { show: boolean; message: string }) {
return (
<AnimatePresence>
{show && (
<motion.div
key="notification"
{...fadeUp}
className="toast"
>
{message}
</motion.div>
)}
</AnimatePresence>
);
}
// 지연 목록
function AnimatedList({ items }: { items: string[] }) {
return (
<motion.ul
initial="hidden"
animate="visible"
variants={{
hidden: {},
visible: { transition: { staggerChildren: 0.06 } },
}}
>
{items.map((item) => (
<motion.li
key={item}
variants={{
hidden: { opacity: 0, x: -12 },
visible: { opacity: 1, x: 0, transition: { duration: 0.2 } },
}}
>
{item}
</motion.li>
))}
</motion.ul>
);
}
CSS를 사용한 스크롤 기반 애니메이션
/* 네이티브 CSS 스크롤 기반 애니메이션 (Chrome 115+) */
@keyframes reveal {
from { opacity: 0; transform: translateY(20px); }
to { opacity: 1; transform: translateY(0); }
}
.scroll-reveal {
animation: reveal linear both;
animation-timeline: view();
animation-range: entry 0% entry 25%;
}
/* 페이지 스크롤에 연결된 진행률 표시줄 */
.scroll-progress {
position: fixed;
top: 0;
left: 0;
height: 3px;
background: var(--color-primary-500);
transform-origin: left;
animation: scaleX linear;
animation-timeline: scroll(root);
}
@keyframes scaleX {
from { transform: scaleX(0); }
to { transform: scaleX(1); }
}
/* 더 넓은 브라우저 지원을 위한 IntersectionObserver 폴백 */
// IntersectionObserver - 모든 브라우저에서 작동
const observer = new IntersectionObserver(
(entries) => {
entries.forEach((entry) => {
if (entry.isIntersecting) {
entry.target.classList.add('in-view');
observer.unobserve(entry.target); // 한 번만 애니메이션
}
});
},
{ threshold: 0.15 }
);
document.querySelectorAll('[data-reveal]').forEach((el) => observer.observe(el));
[data-reveal] {
opacity: 0;
transform: translateY(16px);
transition: opacity 0.3s var(--ease-out), transform 0.3s var(--ease-out);
}
[data-reveal].in-view {
opacity: 1;
transform: translateY(0);
}
AnimatePresence를 사용한 페이지 전환
import { AnimatePresence, motion } from 'framer-motion';
import { usePathname } from 'next/navigation';
const pageVariants = {
initial: { opacity: 0, y: 8 },
animate: { opacity: 1, y: 0, transition: { duration: 0.25, ease: [0, 0, 0.2, 1] } },
exit: { opacity: 0, y: -8, transition: { duration: 0.15, ease: [0.4, 0, 1, 1] } },
};
export function PageTransition({ children }: { children: React.ReactNode }) {
const pathname = usePathname();
return (
<AnimatePresence mode="wait">
<motion.div key={pathname} {...pageVariants}>
{children}
</motion.div>
</AnimatePresence>
);
}
mode="wait"를 사용하여 새 페이지가 들어오기 전에 떠나는 페이지가 완전히 애니메이션 아웃되도록 하세요.mode="sync"(기본값)는 겹침을 유발할 수 있습니다. 페이지 전환을 250ms 미만으로 유지하세요. 사용자는 새 콘텐츠를 보기 위해 기다리고 있습니다.
마이크로인터랙션 - 호버, 프레스, 토글
import { motion } from 'framer-motion';
// 프레스 피드백이 있는 버튼
function Button({ children, onClick }: React.ComponentProps<'button'>) {
return (
<motion.button
whileHover={{ scale: 1.02 }}
whileTap={{ scale: 0.97 }}
transition={{ type: 'spring', stiffness: 500, damping: 30 }}
onClick={onClick}
>
{children}
</motion.button>
);
}
// 애니메이션 토글 스위치 (CSS)
.toggle {
position: relative;
width: 44px;
height: 24px;
background: var(--color-gray-300);
border-radius: 12px;
transition: background 150ms var(--ease-in-out);
cursor: pointer;
}
.toggle[aria-checked="true"] {
background: var(--color-primary-500);
}
.toggle::after {
content: '';
position: absolute;
top: 2px;
left: 2px;
width: 20px;
height: 20px;
border-radius: 50%;
background: white;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.2);
transition: transform 200ms var(--ease-spring);
}
.toggle[aria-checked="true"]::after {
transform: translateX(20px);
}
/* grid-template-rows 트릭을 사용한 아코디언 */
.accordion-content {
display: grid;
grid-template-rows: 0fr;
transition: grid-template-rows 200ms var(--ease-out);
}
.accordion-content[data-open="true"] {
grid-template-rows: 1fr;
}
.accordion-content > div {
overflow: hidden;
}
복잡한 시퀀스를 위한 GSAP 타임라인
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);
// 히어로 등장 시퀀스
function animateHero() {
const tl = gsap.timeline({ defaults: { ease: 'power2.out' } });
tl.from('.hero-badge', { opacity: 0, y: 16, duration: 0.4 })
.from('.hero-headline', { opacity: 0, y: 20, duration: 0.5 }, '-=0.2')
.from('.hero-subtext', { opacity: 0, y: 16, duration: 0.4 }, '-=0.3')
.from('.hero-cta', { opacity: 0, scale: 0.95, duration: 0.35 }, '-=0.2');
return tl;
}
// 스크롤 트리거 기능 카드
gsap.utils.toArray<HTMLElement>('.feature-card').forEach((card, i) => {
gsap.from(card, {
opacity: 0,
y: 32,
duration: 0.5,
delay: i * 0.08,
ease: 'power2.out',
scrollTrigger: {
trigger: card,
start: 'top 85%',
once: true,
},
});
});
GSAP 타임라인에서
'-=0.2'오프셋은 단계 간에 겹침을 만들어 부드럽고 응집력 있는 시퀀스를 만듭니다. 오프셋이 없으면 각 단계가 분리된 느낌입니다. 이전 단계 지속 시간의 20-40%만큼 겹치게 하세요.
prefers-reduced-motion 존중
/* CSS - 안전망 역할의 포괄 규칙 */
@media (prefers-reduced-motion: reduce) {
*,
*::before,
*::after {
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.01ms !important;
scroll-behavior: auto !important;
}
}
// Framer Motion - useReducedMotion 훅
import { useReducedMotion } from 'framer-motion';
function AnimatedCard({ children }: { children: React.ReactNode }) {
const prefersReduced = useReducedMotion();
return (
<motion.div
initial={prefersReduced ? false : { opacity: 0, y: 12 }}
animate={{ opacity: 1, y: 0 }}
transition={prefersReduced ? { duration: 0 } : { duration: 0.2 }}
>
{children}
</motion.div>
);
}
// 바닐라 JS - GSAP 실행 전 선호도 확인
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (!prefersReduced) {
animateHero();
}
안티패턴
| 실수 | 잘못된 이유 | 대신 할 일 |
|---|---|---|
width, height, top, left 애니메이션 | 매 프레임마다 레이아웃 재계산을 트리거하여 버벅거림 유발 | 대신 transform: scale() 또는 transform: translate() 사용 |
transition: all | 예상치 못한 속성을 포착하여 예측 어려움, 성능 위험 | 특정 속성 나열: transition: transform 200ms, opacity 200ms |
| 인터랙티브 피드백에 500ms 이상의 지속 시간 | 사용자가 UI가 느리거나 고장난 것으로 느낌 | 버튼/호버/토글은 200ms 미만, 모달은 300ms 미만 유지 |
| 단순한 호버 효과에 GSAP 사용 | CSS가 기본적으로 처리하는 것에 대한 과도한 오버헤드 | 상태 변경에는 CSS transition 사용, 타임라인에만 GSAP 사용 |
| 총 지연 시간이 500ms 초과 | 사용자는 콘텐츠가 나타나는 것을 보는 대신 기다림 | 항목당 지연을 75ms, 총 지연을 400ms로 제한 |
모든 항목에 will-change: transform | 각 will-change는 GPU 레이어를 생성하여 VRAM 낭비 | 애니메이션할 요소에만 추가하고 애니메이션 후 제거 |
참고 자료
특정 모션 주제에 대한 자세한 지침은 references/ 폴더에서 해당 파일을 읽으세요:
…
[번역을 위해 잘림]