Compétence d'Animation Makepad
Règle de Lecture Sélective
Commencez par :
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Chargez ensuite uniquement les documents, scripts, ressources ou exemples hérités qui correspondent à la tâche réelle de l'utilisateur.
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 modèles ci-dessous
- Répondant aux questions : expliquez les états, transitions, timelines
Quand l'Utiliser
- Vous devez créer ou déboguer des animations, transitions, états de survol ou timelines d'animateur dans Makepad.
- La tâche implique
animator, des changements d'état, des fonctions d'easing, des images clés ou des retours d'interaction visuelle. - Vous souhaitez des modèles d'animation spécifiques à Makepad plutôt que des conseils génériques pour l'UI Rust.
Documentation
Consultez les fichiers locaux pour une documentation détaillée :
./references/animation-system.md- Référence complète sur l'animation
Modèles Avancés
Pour des modèles d'animation prêts pour la production, consultez 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 | Images clés 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 du fichier échoue ou si le fichier est vide :
- Informer l'utilisateur : "本地文档不完整,建议运行
/sync-crate-skills makepad --force更新文档" - Répondre quand même en se basant sur les modèles de SKILL.md + les connaissances intégrées
- Informer l'utilisateur : "本地文档不完整,建议运行
- Si le fichier de référence existe, incorporer 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 de l'état 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 d'animation |
{state} = | Définition de l'état (hover, pressed, focus, disabled) |
default: | Valeur d'état initiale |
{value} = | Définition de la valeur d'é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 de 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
// Rebond
InBack, OutBack, InOutBack
// Bounce
InBounce, OutBounce, InOutBounce
// Personnalisé
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 Communs
| État | Valeurs | Déclencheur |
|---|---|---|
hover | on, off | Entrée/sortie souris |
pressed / down | on, off | Appui/relâchement 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,3 s) pour une 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]);
// Couper vers 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 champ d'application décrit ci-dessus.
- Ne considérez pas le résultat comme un substitut à une validation, un test ou un examen expert spécifique à 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.