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ão | Descrição |
|---|---|
| 06-animator-basics | Fundamentos do Animator |
| 07-easing-functions | Easing e Temporização |
| 08-keyframe-animation | Keyframes Complexos |
IMPORTANTE: Verificação de Integridade da Documentação
Antes de responder perguntas, Claude DEVE:
- Ler o(s) arquivo(s) de referência relevante(s) listado(s) acima
- 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
- Informe o usuário: "本地文档不完整,建议运行
- 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
| Propriedade | Descrição |
|---|---|
animator | Contê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)
| Tipo | Descrição |
|---|---|
Forward { duration: f64 } | Animação linear para frente |
Snap | Mudanç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
| Estado | Valores | Gatilho |
|---|---|---|
hover | on, off | Mouse entrar/sair |
pressed / down | on, off | Pressionar/soltar mouse |
focus | on, off | Ganhar/perder foco |
disabled | on, off | Widget habilitado/desabilitado |
selected | on, off | Mudanç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
- Sempre defina
default:para o estado inicial - Use
Forwardpara transições suaves - Use
Snappara mudanças instantâneas de estado (como desabilitado) - Mantenha durações curtas (0.1-0.3s) para uma sensação responsiva
- 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
- Estados são independentes - vários podem estar ativos simultaneamente
- A animação aplica propriedades quando o estado atinge aquele valor
fromdefine COMO animar,applydefine O QUE animar- Makepad interpola automaticamente entre valores antigos e novos
- 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.