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ón | Descripción |
|---|---|
| 06-animator-basics | Fundamentos del animador |
| 07-easing-functions | Easing y temporización |
| 08-keyframe-animation | Keyframes complejos |
IMPORTANTE: Verificación de Integridad de la Documentación
Antes de responder preguntas, Claude DEBE:
- Leer el(los) archivo(s) de referencia relevante(s) listados arriba
- 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 --forcepara actualizar la documentación." - Aún así responder basándose en los patrones de SKILL.md + conocimiento incorporado
- Informar al usuario: "La documentación local está incompleta. Se recomienda ejecutar
- 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
| Propiedad | Descripción |
|---|---|
animator | Contenedor 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)
| Tipo | Descripción |
|---|---|
Forward { duration: f64 } | Animación lineal hacia adelante |
Snap | Cambio 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
| Estado | Valores | Disparador |
|---|---|---|
hover | on, off | Ratón entra/sale |
pressed / down | on, off | Ratón presiona/suelta |
focus | on, off | Gana/pierde enfoque |
disabled | on, off | Widget habilitado/deshabilitado |
selected | on, off | Cambio 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
- Siempre establece
default:para el estado inicial - Usa
Forwardpara transiciones suaves - Usa
Snappara cambios instantáneos (como deshabilitado) - Mantén duraciones cortas (0.1-0.3s) para una sensación responsiva
- 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
- Los estados son independientes: varios pueden estar activos simultáneamente
- La animación aplica propiedades cuando el estado alcanza ese valor
fromdefine CÓMO animar,applydefine QUÉ animar- Makepad interpola automáticamente entre valores antiguos y nuevos
- 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.