Makepad-Animation-Skill
Version: makepad-widgets (dev-Branch) | Zuletzt aktualisiert: 2026-01-19
Prüfe auf Updates: https://crates.io/crates/makepad-widgets
Du bist ein Experte für Makepad-Animationen. Hilf Benutzern, indem du:
- Code schreibst: Erstelle Animationscode gemäß den folgenden Mustern
- Fragen beantwortest: Erkläre Zustände, Übergänge, Zeitpläne
Wann verwenden
- Du musst Animationen, Übergänge, Hover-Zustände oder Animator-Zeitpläne in Makepad erstellen oder debuggen.
- Die Aufgabe beinhaltet
animator, Zustandsänderungen, Easing, Keyframes oder visuelles Interaktionsfeedback. - Du suchst Makepad-spezifische Animationsmuster anstatt allgemeiner Rust-UI-Anleitung.
Dokumentation
Siehe die lokalen Dateien für eine detaillierte Dokumentation:
./references/animation-system.md- Vollständige Animationsreferenz
Fortgeschrittene Muster
Für produktionsreife Animationsmuster siehe das Verzeichnis _base/:
| Muster | Beschreibung |
|---|---|
| 06-animator-basics | Animator-Grundlagen |
| 07-easing-functions | Easing und Timing |
| 08-keyframe-animation | Komplexe Keyframes |
WICHTIG: Prüfung der Dokumentationsvollständigkeit
Bevor Claude Fragen beantwortet, MUSS er:
- Die relevante(n) oben aufgeführte(n) Referenzdatei(en) lesen
- Wenn das Lesen der Datei fehlschlägt oder die Datei leer ist:
- Benutzer informieren: "Lokale Dokumentation unvollständig. Führe
/sync-crate-skills makepad --forceaus, um die Dokumentation zu aktualisieren." - Trotzdem basierend auf SKILL.md-Mustern + eingebautem Wissen antworten
- Benutzer informieren: "Lokale Dokumentation unvollständig. Führe
- Wenn die Referenzdatei existiert, deren Inhalt in die Antwort einfließen lassen
Wichtige Muster
1. Einfache Hover-Animation
<Button> {
text: "Hover über mich"
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. Multi-Zustands-Animation
<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. Fokus-Zustands-Animation
<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. Deaktivierter Zustand
<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 }
}
}
}
}
}
Animator-Struktur
| Eigenschaft | Beschreibung |
|---|---|
animator | Root-Animation-Container |
{state} = | Zustandsdefinition (hover, pressed, focus, disabled) |
default: | Anfangszustandswert |
{value} = | Zustandswertdefinition (on, off, benutzerdefiniert) |
from: | Übergangszeitplan |
apply: | Zu animierende Eigenschaften |
Timeline-Typen (Play-Enum)
| Typ | Beschreibung |
|---|---|
Forward { duration: f64 } | Lineare Vorwärtsanimation |
Snap | Sofortige Änderung, kein Übergang |
Reverse { duration: f64, end: f64 } | Rückwärtsanimation |
Loop { duration: f64, end: f64 } | Wiederholungsanimation |
BounceLoop { duration: f64, end: f64 } | Bounce-Loop-Animation |
Easing-Funktionen (Ease-Enum)
// Basis
Linear
// Quadratisch
InQuad, OutQuad, InOutQuad
// Kubisch
InCubic, OutCubic, InOutCubic
// Quartisch
InQuart, OutQuart, InOutQuart
// Quintisch
InQuint, OutQuint, InOutQuint
// Sinusförmig
InSine, OutSine, InOutSine
// Exponentiell
InExp, OutExp, InOutExp
// Kreisförmig
InCirc, OutCirc, InOutCirc
// Elastisch
InElastic, OutElastic, InOutElastic
// Zurück
InBack, OutBack, InOutBack
// Bounce
InBounce, OutBounce, InOutBounce
// Benutzerdefiniert
ExpDecay { d1: f64, d2: f64 }
Bezier { cp0: f64, cp1: f64, cp2: f64, cp3: f64 }
Pow { begin: f64, end: f64 }
Easing verwenden
from: {
all: Ease { duration: 0.3, ease: InOutQuad }
}
Häufige Zustände
| Zustand | Werte | Auslöser |
|---|---|---|
hover | on, off | Maus-Eingabe/-Verlassen |
pressed / down | on, off | Maus drücken/loslassen |
focus | on, off | Fokus erhalten/verlieren |
disabled | on, off | Widget aktiviert/deaktiviert |
selected | on, off | Auswahländerung |
Animierbare Eigenschaften
Die meisten draw_* Shader-Uniforms können animiert werden:
- Farben:
color,border_color,shadow_color - Größen:
border_size,border_radius,shadow_radius - Transformationen:
scale,rotation,offset - Deckkraft:
opacity
Beim Schreiben von Code
- Immer
default:für den Anfangszustand setzen Forwardfür weiche Übergänge verwendenSnapfür sofortige Zustandsänderungen (wie deaktiviert) verwenden- Halte Dauern kurz (0,1–0,3 s) für ein reaktionsschnelles Gefühl
- Animiere Shader-Uniforms in
draw_bg,draw_text, etc.
Rust-API (AnimatorImpl-Trait)
pub trait AnimatorImpl {
// In Zustand animieren
fn animator_play(&mut self, cx: &mut Cx, state: &[LiveId; 2]);
// In Zustand springen (keine Animation)
fn animator_cut(&mut self, cx: &mut Cx, state: &[LiveId; 2]);
// Aktuellen Zustand prüfen
fn animator_in_state(&self, cx: &Cx, state: &[LiveId; 2]) -> bool;
}
// Verwendungsbeispiel
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));
}
_ => {}
}
}
Beim Beantworten von Fragen
- Zustände sind unabhängig – mehrere können gleichzeitig aktiv sein
- Animation wendet Eigenschaften an, wenn der Zustand diesen Wert erreicht
fromdefiniert WIE animiert wird,applydefiniert WAS animiert wird- Makepad interpolautomatisch zwischen alten und neuen Werten
- Verwende das Makro
id!(state.value), um Animationszustände in Rust zu referenzieren
Einschränkungen
- Verwende dieses Skill nur, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
- Behandle die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
- Halte an und frage nach Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.