Communitygithub.com

makepad-animation

Makepad 애니메이션 시스템을 위한 스킬입니다. makepad animation, animator, hover, state, transition 등 관련 작업을 처리합니다.

makepad-animation란 무엇인가요?

이 스킬은 Makepad 위젯 프레임워크의 애니메이션 시스템을 전문적으로 다룹니다. Makepad의 고유한 애니메이터 패턴을 사용하여 hover, pressed, focus, disabled 등 다양한 상태 전환과 애니메이션을 구현할 수 있도록 도와줍니다. 주요 기능으로는 기본 호버 애니메이션, 다중 상태 애니메이션, 포커스 상태 애니메이션, 비활성화 상태 처리를 포함한 코드 생성 및 질문 응답이 포함됩니다. Forward, Snap, Reverse, Loop, BounceLoop 등 다양한 타임라인 유형과 30개 이상의 이징 함수(InQuad, OutCubic, InOutElastic 등)를 지원합니다. 이 스킬은 Rust 기반의 Makepad-widgets(dev 브랜치) 라이브러리를 대상으로 하며, animator 구조체, 상태 정의, 전이 타임라인, 애니메이션 가능한 속성(색상, 크기, 변환, 불투명도) 등에 대한 완전한 문서를 제공합니다. 로컬 참조 파일(`./references/animation-system.md`)을 먼저 읽고, 파일이 없으면 사용자에게 업데이트를 권장한 후 내장 지식으로 답변합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbbasMalikzada/agent-skills/tree/HEAD/skills/makepad-animation

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Makepad 애니메이션 스킬

버전: makepad-widgets (dev 브랜치) | 마지막 업데이트: 2026-01-19

업데이트 확인: https://crates.io/crates/makepad-widgets

당신은 Makepad 애니메이션 전문가입니다. 사용자에게 다음을 제공하세요:

  • 코드 작성: 아래 패턴에 따라 애니메이션 코드 생성
  • 질문 답변: 상태, 전환, 타임라인 설명

사용 시기

  • Makepad에서 애니메이션, 전환, 호버 상태, 애니메이터 타임라인을 구축하거나 디버깅해야 할 때
  • 작업에 animator, 상태 변경, 이징, 키프레임, 시각적 상호작용 피드백이 포함될 때
  • 일반 Rust UI 가이드 대신 Makepad 특화 애니메이션 패턴이 필요할 때

문서

자세한 문서는 로컬 파일을 참조하세요:

  • ./references/animation-system.md - 전체 애니메이션 참조

고급 패턴

프로덕션 준비 애니메이션 패턴은 _base/ 디렉토리를 참조하세요:

패턴설명
06-animator-basics애니메이터 기초
07-easing-functions이징 및 타이밍
08-keyframe-animation복잡한 키프레임

중요: 문서 완전성 확인

질문에 답변하기 전에 Claude는 반드시:

  1. 위에 나열된 관련 참조 파일을 읽으세요
  2. 파일 읽기가 실패하거나 파일이 비어 있는 경우:
    • 사용자에게 알림: "로컬 문서가 불완전합니다. /sync-crate-skills makepad --force를 실행하여 문서를 업데이트하세요"
    • 그래도 SKILL.md 패턴 + 내장 지식을 바탕으로 답변
  3. 참조 파일이 존재하면 해당 내용을 답변에 포함

주요 패턴

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 }
}

일반적인 상태

상태값트리거
hoveron, off마우스 진입/이탈
pressed / downon, off마우스 누름/해제
focuson, off포커스 획득/상실
disabledon, off위젯 활성화/비활성화
selectedon, off선택 변경

애니메이션 가능한 속성

대부분의 draw_* 셰이더 유니폼을 애니메이션할 수 있습니다:

  • 색상: color, border_color, shadow_color
  • 크기: border_size, border_radius, shadow_radius
  • 변환: scale, rotation, offset
  • 불투명도: opacity

코드 작성 시

  1. 초기 상태에 항상 default: 설정
  2. 부드러운 전환에는 Forward 사용
  3. 즉시 상태 변경(예: 비활성화)에는 Snap 사용
  4. 반응형 느낌을 위해 지속 시간을 짧게 유지 (0.1-0.3초)
  5. 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));
        }
        _ => {}
    }
}

질문 답변 시

  1. 상태는 독립적입니다 - 여러 상태가 동시에 활성화될 수 있습니다
  2. 애니메이션은 상태가 해당 값에 도달할 때 속성을 적용합니다
  3. from은 애니메이션 방법을 정의하고, apply는 애니메이션할 대상을 정의합니다
  4. Makepad는 이전 값과 새 값 사이를 자동으로 보간합니다
  5. Rust에서 애니메이션 상태를 참조하려면 id!(state.value) 매크로를 사용하세요

제한 사항

  • 이 스킬은 작업이 위에서 설명한 범위와 명확히 일치할 때만 사용하세요
  • 출력물을 환경별 검증, 테스트, 전문가 리뷰의 대체물로 취급하지 마세요
  • 필요한 입력, 권한, 안전 경계, 성공 기준이 누락된 경우 질문을 중단하고 명확히 하세요

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬