Compétence d'animation Makepad
Version : makepad-widgets (branche dev) | Dernière mise à jour : 2026-01-19
Vérifier les mises à jour : https://crates.io/crates/makepad-widgets
Vous êtes un expert des animations Makepad. Aidez les utilisateurs en :
- Écrivant du code : Générer du code d'animation suivant les patrons ci-dessous
- Répondant aux questions : Expliquer les états, transitions, timelines
Quand l'utiliser
- Vous devez construire 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 keyframes, ou un retour d'interaction visuelle. - Vous souhaitez des patrons d'animation spécifiques à Makepad plutôt que des conseils génériques d'UI Rust.
Documentation
Consultez les fichiers locaux pour une documentation détaillée :
./references/animation-system.md- Référence complète sur les animations
Patrons avancés
Pour des patrons d'animation prêts pour la production, voir le répertoire _base/ :
| Patron | 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 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 patrons du 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
Patrons 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 d'état (hover, pressed, focus, disabled) |
default: | Valeur d'état initiale |
{value} = | Définition de valeur d'état (on, off, personnalisée) |
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 inverse |
Loop { duration: f64, end: f64 } | Animation en boucle |
BounceLoop { duration: f64, end: f64 } | Animation de rebond en boucle |
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
InBack, OutBack, InOutBack
// Rebond
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 courants
| État | Valeurs | Déclencheur |
|---|---|---|
hover | on, off | Entrée/sortie de souris |
pressed / down | on, off | Appui/relâchement de 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
- Toujours définir
default:pour l'état initial - Utiliser
Forwardpour des transitions fluides - Utiliser
Snappour des 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 interpole automatiquement entre les anciennes et nouvelles valeurs
- 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 périmètre décrit ci-dessus.
- Ne considérez pas la sortie comme un substitut à une validation, un test ou une revue d'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.