Habilidad de Animación 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 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, fotogramas clave o retroalimentación visual de interacción. - Quieres patrones de animación específicos de Makepad en lugar de guías genéricas de Rust para UI.
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 | Temporización y easing |
| 08-keyframe-animation | Fotogramas clave complejos |
IMPORTANTE: Verificación de Completitud de Documentación
Antes de responder preguntas, Claude DEBE:
- Leer el(los) archivo(s) de referencia relevantes listados arriba
- Si la lectura del archivo falla o el archivo está vacío:
- Informar al usuario: "本地文档不完整,建议运行
/sync-crate-skills makepad --force更新文档" - Responder basándose en los patrones de SKILL.md + conocimiento incorporado
- Informar al usuario: "本地文档不完整,建议运行
- Si el archivo de referencia existe, incorporar su contenido en la respuesta
Patrones Clave
1. Animación Básica de Hover
<Button> {
text: "Pasa 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 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 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 de estado inicial |
{value} = | Definición de valor de 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ásico
Linear
// Cuadrático
InQuad, OutQuad, InOutQuad
// Cúbico
InCubic, OutCubic, InOutCubic
// Cuártico
InQuart, OutQuart, InOutQuart
// Quíntico
InQuint, OutQuint, InOutQuint
// Sinusoidal
InSine, OutSine, InOutSine
// Exponencial
InExp, OutExp, InOutExp
// Circular
InCirc, OutCirc, InOutCirc
// Elástico
InElastic, OutElastic, InOutElastic
// Atrás
InBack, OutBack, InOutBack
// Rebote
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 Comunes
| Estado | Valores | Disparador |
|---|---|---|
hover | on, off | Entrada/salida del ratón |
pressed / down | on, off | Presión/suelta del ratón |
focus | on, off | Ganar/perder el foco |
disabled | on, off | Widget habilitado/deshabilitado |
selected | on, off | Cambio de selección |
Propiedades Animables
La mayoría de los uniforms de shader draw_* se pueden animar:
- 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 establecer
default:para el estado inicial - Usar
Forwardpara transiciones suaves - Usar
Snappara cambios de estado instantáneos (como deshabilitado) - Mantener duraciones cortas (0.1-0.3s) para una sensación de respuesta
- Animar uniforms de 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 (sin animación)
fn animator_cut(&mut self, cx: &mut Cx, state: &[LiveId; 2]);
// Verificar 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 las 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 esta habilidad solo cuando la tarea coincida claramente con el alcance descrito arriba.
- No trates la salida como un sustituto de la validación, pruebas o revisión experta específica del entorno.
- Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.