Compétence d'Animation Makepad
Version : makepad-widgets (branche dev) | Dernière mise à jour : 2026-01-19
Vérifiez les mises à jour : https://crates.io/crates/makepad-widgets
Vous êtes un expert en animations Makepad. Aidez les utilisateurs en :
- Écrivant du code : Générez du code d'animation en suivant les motifs ci-dessous
- Répondant aux questions : Expliquez les états, transitions et timelines
Quand l'utiliser
- Vous devez construire ou déboguer des animations, transitions, états de survol ou timelines d'animator dans Makepad.
- La tâche implique
animator, changements d'état, easings, keyframes ou retour d'interaction visuelle. - Vous souhaitez des motifs d'animation spécifiques à Makepad plutôt que des conseils génériques sur l'UI Rust.
Documentation
Consultez les fichiers locaux pour une documentation détaillée :
./references/animation-system.md- Référence complète des animations
Motifs avancés
Pour des motifs d'animation prêts pour la production, voir le répertoire _base/ :
| Motif | Description |
|---|---|
| 06-animator-basics | Fondamentaux de l'animator |
| 07-easing-functions | Easing et temporisation |
| 08-keyframe-animation | Keyframes complexes |
IMPORTANT : Vérification de l'exhaustivité de la documentation
Avant de répondre aux questions, Claude DOIT :
- Lire le(s) fichier(s) de référence pertinent(s) listé(s) ci-dessus
- Si la lecture du fichier échoue ou si le fichier est vide :
- Informer l'utilisateur : "La documentation locale est incomplète. Il est recommandé d'exécuter
/sync-crate-skills makepad --forcepour mettre à jour la documentation." - Répondre quand même en se basant sur les motifs de SKILL.md et les connaissances intégrées
- Informer l'utilisateur : "La documentation locale est incomplète. Il est recommandé d'exécuter
- Si le fichier de référence existe, intégrer son contenu dans la réponse
Motifs clés
1. Animation de survol de base
<Button> {
text: "Survolez-moi"
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. Animation multi-états
<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. Animation de l'état de focus
<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. État désactivé
<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 }
}
}
}
}
}
Structure de l'animator
| Propriété | Description |
|---|---|
animator | Conteneur racine d'animation |
{state} = | Définition d'état (hover, pressed, focus, disabled) |
default: | Valeur d'état initiale |
{value} = | Définition de valeur d'état (on, off, custom) |
from: | Timeline de transition |
apply: | Propriétés à animer |
Types de timeline (Play Enum)
| Type | Description |
|---|---|
Forward { duration: f64 } | Animation linéaire avant |
Snap | Changement instantané, sans transition |
Reverse { duration: f64, end: f64 } | Animation inversée |
Loop { duration: f64, end: f64 } | Animation en boucle |
BounceLoop { duration: f64, end: f64 } | Animation de rebond en boucle |
Fonctions d'easing (Ease Enum)
// Basique
Linear
// Quadratiques
InQuad, OutQuad, InOutQuad
// Cubiques
InCubic, OutCubic, InOutCubic
// Quartiques
InQuart, OutQuart, InOutQuart
// Quintiques
InQuint, OutQuint, InOutQuint
// Sinusoïdales
InSine, OutSine, InOutSine
// Exponentielles
InExp, OutExp, InOutExp
// Circulaires
InCirc, OutCirc, InOutCirc
// Élastiques
InElastic, OutElastic, InOutElastic
// Back
InBack, OutBack, InOutBack
// Bounce
InBounce, OutBounce, InOutBounce
// Personnalisées
ExpDecay { d1: f64, d2: f64 }
Bezier { cp0: f64, cp1: f64, cp2: f64, cp3: f64 }
Pow { begin: f64, end: f64 }
Utilisation de l'easing
from: {
all: Ease { duration: 0.3, ease: InOutQuad }
}
États courants
| État | Valeurs | Déclencheur |
|---|---|---|
hover | on, off | Entrée/sortie de la souris |
pressed / down | on, off | Appui/relâchement de la souris |
focus | on, off | Gain/perte de focus |
disabled | on, off | Widget activé/désactivé |
selected | on, off | Changement de sélection |
Propriétés animables
La plupart des uniforms de shader draw_* peuvent être animés :
- Couleurs :
color,border_color,shadow_color - Tailles :
border_size,border_radius,shadow_radius - Transformations :
scale,rotation,offset - Opacité :
opacity
Lors de l'écriture de code
- Toujours définir
default:pour l'état initial - Utiliser
Forwardpour les transitions fluides - Utiliser
Snappour les changements d'état instantanés (comme désactivé) - Garder les durées courtes (0.1-0.3s) pour une sensation de réactivité
- Animer les uniforms de shader dans
draw_bg,draw_text, etc.
API Rust (Trait AnimatorImpl)
pub trait AnimatorImpl {
// Animer vers un état
fn animator_play(&mut self, cx: &mut Cx, state: &[LiveId; 2]);
// Passer à un état (sans animation)
fn animator_cut(&mut self, cx: &mut Cx, state: &[LiveId; 2]);
// Vérifier l'état actuel
fn animator_in_state(&self, cx: &Cx, state: &[LiveId; 2]) -> bool;
}
// Exemple d'utilisation
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));
}
_ => {}
}
}
Lors de la réponse aux questions
- Les états sont indépendants - plusieurs peuvent être actifs simultanément
- L'animation applique les propriétés lorsque l'état atteint cette valeur
fromdéfinit COMMENT animer,applydéfinit QUOI animer- Makepad effectue une interpolation entre les anciennes et nouvelles valeurs automatiquement
- Utilisez la macro
id!(state.value)pour référencer les états d'animation en Rust
Limitations
- Utilisez cette compétence uniquement lorsque la tâche correspond clairement au cadre décrit ci-dessus.
- Ne considérez pas la sortie comme un substitut à une validation, un test ou une revue d'expert spécifiques à l'environnement.
- Arrêtez-vous et demandez des clarifications si les entrées, autorisations, limites de sécurité ou critères de succès requis sont manquants.