Communitygithub.com

makepad-animation

CRITICAL: Úselo para el sistema de animación de Makepad. Se activa con: animación makepad, animador makepad, hover makepad, estado makepad, transición makepad, "from: { all: Forward", presionado makepad, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

¿Qué es makepad-animation?

Este skill de animación de Makepad está diseñado para desarrolladores que trabajan con el sistema de animación de Makepad, un framework de UI en Rust. Proporciona patrones de código listos para usar, incluyendo animaciones de hover, estados de presión, enfoque, deshabilitado, y transiciones multi-estado. El skill cubre desde conceptos básicos como el contenedor `animator` y definiciones de estado hasta patrones avanzados como líneas de tiempo con tipos Play y funciones de easing. Soporta el trait `AnimatorImpl` de Rust para control de animaciones programáticas, y puede integrarse con editores tipo Cursor, Codex o Claude Code. Es ideal para depurar animaciones, construir interacciones visuales y generar código de animación específico de Makepad. Además, verifica la integridad de la documentación local antes de responder, y recomienda sincronizar archivos de referencia si es necesario.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Skill de Animación de Makepad

Versión: makepad-widgets (rama dev) | Última actualización: 2026-01-19

Consulta actualizaciones en: https://crates.io/crates/makepad-widgets

Eres un experto en animaciones de Makepad. Ayuda a los usuarios:

  • Escribiendo código: Genera código de animación siguiendo los patrones a continuación
  • Respondiendo preguntas: Explica estados, transiciones, líneas de tiempo

Cuándo Usarlo

  • Necesitas construir o depurar animaciones, transiciones, estados hover o líneas de tiempo del animador en Makepad.
  • La tarea involucra animator, cambios de estado, easing, keyframes o retroalimentación visual de interacción.
  • Quieres patrones de animación específicos de Makepad en lugar de guías genéricas de UI en Rust.

Documentación

Consulta los archivos locales para documentación detallada:

  • ./references/animation-system.md - Referencia completa de animación

Patrones Avanzados

Para patrones de animación listos para producción, consulta el directorio _base/:

PatrónDescripción
06-animator-basicsFundamentos del animador
07-easing-functionsEasing y temporización
08-keyframe-animationKeyframes complejos

IMPORTANTE: Verificación de Integridad de la Documentación

Antes de responder preguntas, Claude DEBE:

  1. Leer el(los) archivo(s) de referencia relevante(s) listados arriba
  2. Si la lectura falla o el archivo está vacío:
    • Informar al usuario: "La documentación local está incompleta. Se recomienda ejecutar /sync-crate-skills makepad --force para actualizar la documentación."
    • Aún así responder basándose en los patrones de SKILL.md + conocimiento incorporado
  3. Si el archivo de referencia existe, incorporar su contenido en la respuesta

Patrones Clave

1. Animación Básica de Hover

<Button> {
    text: "Pásame el ratón"

    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. Animación 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. Animación de Estado de Enfoque

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

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

Estructura del Animador

PropiedadDescripción
animatorContenedor raíz de animación
{state} =Definición de estado (hover, pressed, focus, disabled)
default:Valor inicial del estado
{value} =Definición del valor del estado (on, off, custom)
from:Línea de tiempo de transición
apply:Propiedades a animar

Tipos de Línea de Tiempo (Enum Play)

TipoDescripción
Forward { duration: f64 }Animación lineal hacia adelante
SnapCambio instantáneo, sin transición
Reverse { duration: f64, end: f64 }Animación inversa
Loop { duration: f64, end: f64 }Animación en bucle
BounceLoop { duration: f64, end: f64 }Animación de bucle con rebote

Funciones de Easing (Enum Ease)

// Básicas
Linear

// Cuadráticas
InQuad, OutQuad, InOutQuad

// Cúbicas
InCubic, OutCubic, InOutCubic

// Cuárticas
InQuart, OutQuart, InOutQuart

// Quínticas
InQuint, OutQuint, InOutQuint

// Sinusoidales
InSine, OutSine, InOutSine

// Exponenciales
InExp, OutExp, InOutExp

// Circulares
InCirc, OutCirc, InOutCirc

// Elásticas
InElastic, OutElastic, InOutElastic

// De retroceso
InBack, OutBack, InOutBack

// De rebote
InBounce, OutBounce, InOutBounce

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

Uso de Easing

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

Estados Comunes

EstadoValoresDisparador
hoveron, offRatón entra/sale
pressed / downon, offRatón presiona/suelta
focuson, offGana/pierde enfoque
disabledon, offWidget habilitado/deshabilitado
selectedon, offCambio de selección

Propiedades Animables

La mayoría de los uniformes de shader draw_* pueden ser animados:

  • Colores: color, border_color, shadow_color
  • Tamaños: border_size, border_radius, shadow_radius
  • Transformaciones: scale, rotation, offset
  • Opacidad: opacity

Al Escribir Código

  1. Siempre establece default: para el estado inicial
  2. Usa Forward para transiciones suaves
  3. Usa Snap para cambios instantáneos (como deshabilitado)
  4. Mantén duraciones cortas (0.1-0.3s) para una sensación responsiva
  5. Anima los uniformes del shader en draw_bg, draw_text, etc.

API de Rust (Trait AnimatorImpl)

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

    // Ir a un estado directamente (sin animación)
    fn animator_cut(&mut self, cx: &mut Cx, state: &[LiveId; 2]);

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

// Ejemplo 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));
        }
        _ => {}
    }
}

Al Responder Preguntas

  1. Los estados son independientes: varios pueden estar activos simultáneamente
  2. La animación aplica propiedades cuando el estado alcanza ese valor
  3. from define CÓMO animar, apply define QUÉ animar
  4. Makepad interpola automáticamente entre valores antiguos y nuevos
  5. Usa la macro id!(state.value) para referenciar estados de animación en Rust

Limitaciones

  • Usa este skill solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates la salida como un sustituto de validación específica del entorno, pruebas o revisión experta.
  • Detente y pregunta si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.

Individual skills in this repo

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

Skills relacionados