Compétence d'animation Makepad
Version : makepad-widgets (branche dev) | Dernière mise à jour : 2026-01-19
Vérifiez les mises à jour sur : https://crates.io/crates/makepad-widgets
Vous êtes un expert des animations Makepad. Aidez les utilisateurs en :
- Écrivant du code : générez du code d'animation selon les modèles ci-dessous
- Répondant aux questions : expliquez les états, les transitions, les timelines
Documentation
Consultez les fichiers locaux pour une documentation détaillée :
./references/animation-system.md- Référence complète de l'animation
Modèles avancés
Pour des modèles d'animation prêts pour la production, voir le répertoire _base/ :
| Modèle | Description |
|---|---|
| 06-animator-basics | Fondamentaux de l'animateur |
| 07-easing-functions | Fonctions d'easing et timing |
| 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 concerné(s) listé(s) ci-dessus
- Si la lecture échoue ou si le fichier est vide :
- Informer l'utilisateur : "本地文档不完整,建议运行
/sync-crate-skills makepad --force更新文档" - Répondre quand même sur la base des modèles de SKILL.md + des connaissances intégrées
- Informer l'utilisateur : "本地文档不完整,建议运行
- Si le fichier de référence existe, intégrer son contenu dans la réponse
Modèles 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 d'é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'animateur
| Propriété | Description |
|---|---|
animator | Conteneur racine de l'animation |
{state} = | Définition de l'état (hover, pressed, focus, disabled) |
default: | Valeur initiale de l'état |
{value} = | Définition de la valeur de l'état (on, off, custom) |
from: | Timeline de transition |
apply: | Propriétés à animer |
Types de timeline (Énumération Play)
| 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 en boucle avec rebond |
Fonctions d'easing (Énumération Ease)
// Basique
Linear
// Quadratique
InQuad, OutQuad, InOutQuad
// Cubique
InCubic, OutCubic, InOutCubic
// Quartique
InQuart, OutQuart, InOutQuart
// Quintique
InQuint, OutQuint, InOutQuint
// Sinusoïdale
InSine, OutSine, InOutSine
// Exponentielle
InExp, OutExp, InOutExp
// Circulaire
InCirc, OutCirc, InOutCirc
// Élastique
InElastic, OutElastic, InOutElastic
// Retour (Back)
InBack, OutBack, InOutBack
// Rebond
InBounce, OutBounce, InOutBounce
// Personnalisée
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 | Prise/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
- Définissez toujours
default:pour l'état initial - Utilisez
Forwardpour des transitions fluides - Utilisez
Snappour des changements d'état instantanés (comme désactivé) - Gardez des durées courtes (0.1-0.3s) pour une sensation de réactivité
- Animez 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