Communitygithub.com

makepad-animation

CRÍTICO: Use para o sistema de animação do Makepad. Ativa em: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

O que é makepad-animation?

Esta skill capacita assistentes de IA (como Claude Code, Cursor ou Codex) a serem especialistas no sistema de animação do Makepad. Ela fornece um guia completo e padrões de código para criar animações responsivas para widgets Makepad, incluindo estados de hover, pressionado, foco e desabilitado. A skill oferece uma referência detalhada sobre a estrutura do animator: os blocos 'from' e 'apply', os tipos de timeline (Forward, Snap, Reverse, Loop, BounceLoop), funções de easing (como InOutQuad e Bezier) e propriedades animáveis (cores, tamanhos, transformações). Ela também cobre a API Rust (trait AnimatorImpl) para controle programático de animações e inclui verificações de integridade da documentação, instruindo o assistente a ler arquivos de referência local e sugerir sincronização se eles estiverem faltando. A skill é útil para desenvolvedores que trabalham com a UI do Makepad no ambiente Rust, ajudando-os a construir animações fluidas e padrão para interfaces interativas.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Skill de Animação Makepad

Versão: makepad-widgets (branch dev) | Última Atualização: 2026-01-19

Verifique atualizações em: https://crates.io/crates/makepad-widgets

Você é um especialista em animações Makepad. Ajude os usuários:

  • Escrevendo código: Gere código de animação seguindo os padrões abaixo
  • Respondendo perguntas: Explique estados, transições, timelines

Quando Usar

  • Você precisa construir ou depurar animações, transições, estados de hover ou timelines do animator no Makepad.
  • A tarefa envolve animator, mudanças de estado, easing, keyframes ou feedback visual de interação.
  • Você deseja padrões de animação específicos do Makepad, em vez de orientação genérica de UI Rust.

Documentação

Consulte os arquivos locais para documentação detalhada:

  • ./references/animation-system.md - Referência completa de animação

Padrões Avançados

Para padrões de animação prontos para produção, veja o diretório _base/:

PadrãoDescrição
06-animator-basicsFundamentos do Animator
07-easing-functionsEasing e Temporização
08-keyframe-animationKeyframes Complexos

IMPORTANTE: Verificação de Integridade da Documentação

Antes de responder perguntas, Claude DEVE:

  1. Ler o(s) arquivo(s) de referência relevante(s) listado(s) acima
  2. Se a leitura do arquivo falhar ou o arquivo estiver vazio:
    • Informe o usuário: "本地文档不完整,建议运行 /sync-crate-skills makepad --force 更新文档"
    • Ainda responda com base nos padrões da SKILL.md + conhecimento interno
  3. Se o arquivo de referência existir, incorpore seu conteúdo na resposta

Padrões Principais

1. Animação Básica de Hover

<Button> {
    text: "Passe o Mouse"

    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. Animação Multi-Estado

<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. Animação de Estado de Foco

<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. Estado Desabilitado

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

Estrutura do Animator

PropriedadeDescrição
animatorContêiner raiz da animação
{state} =Definição do estado (hover, pressed, focus, disabled)
default:Valor do estado inicial
{value} =Definição do valor do estado (on, off, custom)
from:Timeline de transição
apply:Propriedades a serem animadas

Tipos de Timeline (Enum Play)

TipoDescrição
Forward { duration: f64 }Animação linear para frente
SnapMudança instantânea, sem transição
Reverse { duration: f64, end: f64 }Animação reversa
Loop { duration: f64, end: f64 }Animação em loop
BounceLoop { duration: f64, end: f64 }Animação de loop com bounce

Funções de Easing (Enum Ease)

// Básico
Linear

// Quadrático
InQuad, OutQuad, InOutQuad

// Cúbico
InCubic, OutCubic, InOutCubic

// Quártico
InQuart, OutQuart, InOutQuart

// Quíntico
InQuint, OutQuint, InOutQuint

// Senoidal
InSine, OutSine, InOutSine

// Exponencial
InExp, OutExp, InOutExp

// Circular
InCirc, OutCirc, InOutCirc

// Elástico
InElastic, OutElastic, InOutElastic

// Volta
InBack, OutBack, InOutBack

// Bounce
InBounce, OutBounce, InOutBounce

// Personalizado
ExpDecay { d1: f64, d2: f64 }
Bezier { cp0: f64, cp1: f64, cp2: f64, cp3: f64 }
Pow { begin: f64, end: f64 }

Usando Easing

from: {
    all: Ease { duration: 0.3, ease: InOutQuad }
}

Estados Comuns

EstadoValoresGatilho
hoveron, offMouse entrar/sair
pressed / downon, offPressionar/soltar mouse
focuson, offGanhar/perder foco
disabledon, offWidget habilitado/desabilitado
selectedon, offMudança de seleção

Propriedades Animáveis

A maioria dos uniforms de shader draw_* pode ser animada:

  • Cores: color, border_color, shadow_color
  • Tamanhos: border_size, border_radius, shadow_radius
  • Transformações: scale, rotation, offset
  • Opacidade: opacity

Ao Escrever Código

  1. Sempre defina default: para o estado inicial
  2. Use Forward para transições suaves
  3. Use Snap para mudanças instantâneas de estado (como desabilitado)
  4. Mantenha durações curtas (0.1-0.3s) para uma sensação responsiva
  5. Anime uniforms de shader em draw_bg, draw_text, etc.

API Rust (Trait AnimatorImpl)

pub trait AnimatorImpl {
    // Animar para o estado
    fn animator_play(&mut self, cx: &mut Cx, state: &[LiveId; 2]);

    // Ir direto para o estado (sem animação)
    fn animator_cut(&mut self, cx: &mut Cx, state: &[LiveId; 2]);

    // Verificar estado atual
    fn animator_in_state(&self, cx: &Cx, state: &[LiveId; 2]) -> bool;
}

// Exemplo de uso
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));
        }
        _ => {}
    }
}

Ao Responder Perguntas

  1. Estados são independentes - vários podem estar ativos simultaneamente
  2. A animação aplica propriedades quando o estado atinge aquele valor
  3. from define COMO animar, apply define O QUE animar
  4. Makepad interpola automaticamente entre valores antigos e novos
  5. Use a macro id!(state.value) para referenciar estados de animação em Rust

Limitações

  • Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
  • Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
  • Pare e peça esclarecimentos se as entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem faltando.

Individual skills in this repo

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

Habilidades Relacionadas