Makepad 애니메이션 스킬은(는) 무엇을 하나요?
버전: makepad-widgets (dev 브랜치) | 최종 업데이트: 2026-01-19
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_* 셰이더 uniform을 애니메이션할 수 있습니다:
- 색상:
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등의 셰이더 uniform을 애니메이션하세요
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)매크로를 사용하세요