Makepad 애니메이션 스킬
버전: makepad-widgets (dev 브랜치) | 마지막 업데이트: 2026-01-19
당신은 Makepad 애니메이션 전문가입니다. 사용자에게 다음을 제공하세요:
- 코드 작성: 아래 패턴에 따라 애니메이션 코드 생성
- 질문 답변: 상태, 전환, 타임라인 설명
사용 시기
- Makepad에서 애니메이션, 전환, 호버 상태, 애니메이터 타임라인을 구축하거나 디버깅해야 할 때
- 작업에
animator, 상태 변경, 이징, 키프레임, 시각적 상호작용 피드백이 포함될 때 - 일반 Rust UI 가이드 대신 Makepad 특화 애니메이션 패턴이 필요할 때
문서
자세한 문서는 로컬 파일을 참조하세요:
./references/animation-system.md- 전체 애니메이션 참조
고급 패턴
프로덕션 준비 애니메이션 패턴은 _base/ 디렉토리를 참조하세요:
| 패턴 | 설명 |
|---|---|
| 06-animator-basics | 애니메이터 기초 |
| 07-easing-functions | 이징 및 타이밍 |
| 08-keyframe-animation | 복잡한 키프레임 |
중요: 문서 완전성 확인
질문에 답변하기 전에 Claude는 반드시:
- 위에 나열된 관련 참조 파일을 읽으세요
- 파일 읽기가 실패하거나 파일이 비어 있는 경우:
- 사용자에게 알림: "로컬 문서가 불완전합니다.
/sync-crate-skills makepad --force를 실행하여 문서를 업데이트하세요" - 그래도 SKILL.md 패턴 + 내장 지식을 바탕으로 답변
- 사용자에게 알림: "로컬 문서가 불완전합니다.
- 참조 파일이 존재하면 해당 내용을 답변에 포함
주요 패턴
1. 기본 호버 애니메이션
<Button> {
text: "Hover Me"
animator: {
hover = {
default: off
off = {
from: { all: Forward { duration: 0.15 } }
apply: {
draw_bg: { color: #333333 }
}
}
on = {
from: { all: Forward { duration: 0.15 } }
apply: {
draw_bg: { color: #555555 }
}
}
}
}
}
2. 다중 상태 애니메이션
<View> {
animator: {
hover = {
default: off
off = {
from: { all: Forward { duration: 0.2 } }
apply: { draw_bg: { color: #222222 } }
}
on = {
from: { all: Forward { duration: 0.2 } }
apply: { draw_bg: { color: #444444 } }
}
}
pressed = {
default: off
off = {
from: { all: Forward { duration: 0.1 } }
apply: { draw_bg: { scale: 1.0 } }
}
on = {
from: { all: Forward { duration: 0.1 } }
apply: { draw_bg: { scale: 0.95 } }
}
}
}
}
3. 포커스 상태 애니메이션
<TextInput> {
animator: {
focus = {
default: off
off = {
from: { all: Forward { duration: 0.2 } }
apply: {
draw_bg: {
border_color: #444444
border_size: 1.0
}
}
}
on = {
from: { all: Forward { duration: 0.2 } }
apply: {
draw_bg: {
border_color: #0066CC
border_size: 2.0
}
}
}
}
}
}
4. 비활성화 상태
<Button> {
animator: {
disabled = {
default: off
off = {
from: { all: Snap }
apply: {
draw_bg: { color: #0066CC }
draw_text: { color: #FFFFFF }
}
}
on = {
from: { all: Snap }
apply: {
draw_bg: { color: #333333 }
draw_text: { color: #666666 }
}
}
}
}
}
애니메이터 구조
| 속성 | 설명 |
|---|---|
animator | 루트 애니메이션 컨테이너 |
{state} = | 상태 정의 (hover, pressed, focus, disabled) |
default: | 초기 상태 값 |
{value} = | 상태 값 정의 (on, off, 사용자 정의) |
from: | 전환 타임라인 |
apply: | 애니메이션할 속성 |
타임라인 유형 (Play 열거형)
| 유형 | 설명 |
|---|---|
Forward { duration: f64 } | 선형 전진 애니메이션 |
Snap | 즉시 변경, 전환 없음 |
Reverse { duration: f64, end: f64 } | 역방향 애니메이션 |
Loop { duration: f64, end: f64 } | 반복 애니메이션 |
BounceLoop { duration: f64, end: f64 } | 바운스 반복 애니메이션 |
이징 함수 (Ease 열거형)
// 기본
Linear
// 2차
InQuad, OutQuad, InOutQuad
// 3차
InCubic, OutCubic, InOutCubic
// 4차
InQuart, OutQuart, InOutQuart
// 5차
InQuint, OutQuint, InOutQuint
// 사인
InSine, OutSine, InOutSine
// 지수
InExp, OutExp, InOutExp
// 원형
InCirc, OutCirc, InOutCirc
// 탄성
InElastic, OutElastic, InOutElastic
// 백
InBack, OutBack, InOutBack
// 바운스
InBounce, OutBounce, InOutBounce
// 사용자 정의
ExpDecay { d1: f64, d2: f64 }
Bezier { cp0: f64, cp1: f64, cp2: f64, cp3: f64 }
Pow { begin: f64, end: f64 }
이징 사용 예시
from: {
all: Ease { duration: 0.3, ease: InOutQuad }
}
일반적인 상태
| 상태 | 값 | 트리거 |
|---|---|---|
hover | on, off | 마우스 진입/이탈 |
pressed / down | on, off | 마우스 누름/해제 |
focus | on, off | 포커스 획득/상실 |
disabled | on, off | 위젯 활성화/비활성화 |
selected | on, off | 선택 변경 |
애니메이션 가능한 속성
대부분의 draw_* 셰이더 유니폼을 애니메이션할 수 있습니다:
- 색상:
color,border_color,shadow_color - 크기:
border_size,border_radius,shadow_radius - 변환:
scale,rotation,offset - 불투명도:
opacity
코드 작성 시
- 초기 상태에 항상
default:설정 - 부드러운 전환에는
Forward사용 - 즉시 상태 변경(예: 비활성화)에는
Snap사용 - 반응형 느낌을 위해 지속 시간을 짧게 유지 (0.1-0.3초)
draw_bg,draw_text등의 셰이더 유니폼을 애니메이션
Rust API (AnimatorImpl 트레이트)
pub trait AnimatorImpl {
// 상태로 애니메이션
fn animator_play(&mut self, cx: &mut Cx, state: &[LiveId; 2]);
// 상태로 즉시 전환 (애니메이션 없음)
fn animator_cut(&mut self, cx: &mut Cx, state: &[LiveId; 2]);
// 현재 상태 확인
fn animator_in_state(&self, cx: &Cx, state: &[LiveId; 2]) -> bool;
}
// 사용 예시
fn handle_event(&mut self, cx: &mut Cx, event: &Event, scope: &mut Scope) {
match event.hits(cx, self.area()) {
Hit::FingerHoverIn(_) => {
self.animator_play(cx, id!(hover.on));
}
Hit::FingerHoverOut(_) => {
self.animator_play(cx, id!(hover.off));
}
Hit::FingerDown(_) => {
self.animator_play(cx, id!(pressed.on));
}
Hit::FingerUp(_) => {
self.animator_play(cx, id!(pressed.off));
}
_ => {}
}
}
질문 답변 시
- 상태는 독립적입니다 - 여러 상태가 동시에 활성화될 수 있습니다
- 애니메이션은 상태가 해당 값에 도달할 때 속성을 적용합니다
from은 애니메이션 방법을 정의하고,apply는 애니메이션할 대상을 정의합니다- Makepad는 이전 값과 새 값 사이를 자동으로 보간합니다
- Rust에서 애니메이션 상태를 참조하려면
id!(state.value)매크로를 사용하세요
제한 사항
- 이 스킬은 작업이 위에서 설명한 범위와 명확히 일치할 때만 사용하세요
- 출력물을 환경별 검증, 테스트, 전문가 리뷰의 대체물로 취급하지 마세요
- 필요한 입력, 권한, 안전 경계, 성공 기준이 누락된 경우 질문을 중단하고 명확히 하세요