Makepad-Animation-Fähigkeit
Version: makepad-widgets (dev-Branch) | Zuletzt aktualisiert: 2026-01-19
Auf Updates prüfen: https://crates.io/crates/makepad-widgets
Sie sind ein Experte für Makepad-Animationen. Helfen Sie Benutzern, indem Sie:
- Code schreiben: Animationscode nach den untenstehenden Mustern generieren
- Fragen beantworten: Zustände, Übergänge und Zeitachsen erklären
Wann verwenden
- Sie müssen Animationen, Übergänge, Hover-Zustände oder Animator-Zeitachsen in Makepad erstellen oder debuggen.
- Die Aufgabe beinhaltet
animator, Zustandsänderungen, Easing, Keyframes oder visuelles Interaktionsfeedback. - Sie möchten Makepad-spezifische Animationsmuster anstelle allgemeiner Rust-UI-Anleitungen.
Dokumentation
Siehe die lokalen Dateien für 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) Referenzdatei(en) oben lesen
- Wenn das Lesen der Datei fehlschlägt oder die Datei leer ist:
- Benutzer informieren: "Die lokale Dokumentation ist unvollständig. Es wird empfohlen,
/sync-crate-skills makepad --forceauszuführen, um die Dokumentation zu aktualisieren." - Trotzdem basierend auf den SKILL.md-Mustern + eingebautem Wissen antworten
- Benutzer informieren: "Die lokale Dokumentation ist unvollständig. Es wird empfohlen,
- Wenn die Referenzdatei existiert, deren Inhalt in die Antwort einfließen lassen
Schlüsselmuster
1. Basis-Hover-Animation
<Button> {
text: "Hover Me"
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. Mehr-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-Animationscontainer |
{zustand} = | Zustandsdefinition (hover, pressed, focus, disabled) |
default: | Anfangszustandswert |
{wert} = | Zustandswertdefinition (on, off, benutzerdefiniert) |
from: | Übergangszeitachse |
apply: | Zu animierende Eigenschaften |
Zeitachsentypen (Play-Enum)
| Typ | Beschreibung |
|---|---|
Forward { duration: f64 } | Lineare Vorwärtsanimation |
Snap | Sofortige Änderung, kein Übergang |
Reverse { duration: f64, end: f64 } | Rückwärts-Animation |
Loop { duration: f64, end: f64 } | Wiederholungs-Animation |
BounceLoop { duration: f64, end: f64 } | Springende Wiederholungs-Animation |
Easing-Funktionen (Ease-Enum)
// Basis
Linear
// Quadratisch
InQuad, OutQuad, InOutQuad
// Kubisch
InCubic, OutCubic, InOutCubic
// Quartisch
InQuart, OutQuart, InOutQuart
// Quintisch
InQuint, OutQuint, InOutQuint
// Sinusoidal
InSine, OutSine, InOutSine
// Exponentiell
InExp, OutExp, InOutExp
// Kreisförmig
InCirc, OutCirc, InOutCirc
// Elastisch
InElastic, OutElastic, InOutElastic
// Zurückschwingend
InBack, OutBack, InOutBack
// Springend
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 ein/aus |
pressed / down | on, off | Maus gedrückt/losgelassen |
focus | on, off | Fokus erhalten/verloren |
disabled | on, off | Widget aktiviert/deaktiviert |
selected | on, off | Auswahl geändert |
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 fließende Übergänge verwendenSnapfür sofortige Zustandsänderungen (wie deaktiviert) verwenden- Kurze Dauern (0,1-0,3s) für ein reaktionsschnelles Gefühl einhalten
- Shader-Uniforms in
draw_bg,draw_text, etc. animieren
Rust-API (AnimatorImpl-Trait)
pub trait AnimatorImpl {
// In einen Zustand animieren
fn animator_play(&mut self, cx: &mut Cx, state: &[LiveId; 2]);
// In einen Zustand springen (ohne 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
- Die Animation wendet Eigenschaften an, wenn der Zustand diesen Wert erreicht
fromdefiniert WIE animiert wird,applydefiniert WAS animiert wird- Makepad überblendet automatisch zwischen alten und neuen Werten
- Verwenden Sie das Makro
id!(zustand.wert), um Animationszustände in Rust zu referenzieren
Einschränkungen
- Verwenden Sie diese Fähigkeit nur, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
- Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
- Halten Sie an und fragen Sie nach, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.