Makepad 動畫技能
版本: makepad-widgets (dev branch) | 最後更新: 2026-01-19
您是 Makepad 動畫專家。幫助使用者:
- 撰寫程式碼:依照下列模式產生動畫程式碼
- 回答問題:解釋狀態(states)、過渡(transitions)、時間軸(timelines)
使用時機
- 您需要在 Makepad 中建立或除錯動畫、過渡、懸停狀態或動畫時間軸。
- 任務涉及
animator、狀態改變、easing、keyframes 或視覺互動回饋。 - 您想要 Makepad 專屬的動畫模式,而非通用的 Rust UI 指導。
文件
請參考本機詳細文件:
./references/animation-system.md- 完整的動畫參考
進階模式
如需生產就緒的動畫模式,請參閱 _base/ 目錄:
| 模式 | 說明 |
|---|---|
| 06-animator-basics | 動畫基礎 |
| 07-easing-functions | 緩動與時間控制 |
| 08-keyframe-animation | 複雜關鍵幀動畫 |
重要:文件完整性檢查
在回答問題之前,Claude 必須:
- 閱讀上述相關參考檔案
- 若檔案讀取失敗或為空:
- 告知使用者:「本地文档不完整,建议运行
/sync-crate-skills makepad --force更新文档」 - 仍根據 SKILL.md 模式 + 內建知識回答
- 告知使用者:「本地文档不完整,建议运行
- 若參考檔案存在,將其內容融入回答中
關鍵模式
1. 基本懸停動畫
<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. 多狀態動畫
<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. 焦點狀態動畫
<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. 禁用狀態
<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 | 動畫容器根節點 |
{state} = | 狀態定義(hover, pressed, focus, disabled) |
default: | 初始狀態值 |
{value} = | 狀態值定義(on, off, 自訂) |
from: | 過渡時間軸 |
apply: | 要動畫化的屬性 |
時間軸類型(Play 列舉)
| 類型 | 說明 |
|---|---|
Forward { duration: f64 } | 線性前進動畫 |
Snap | 立即變化,無過渡 |
Reverse { duration: f64, end: f64 } | 反向動畫 |
Loop { duration: f64, end: f64 } | 循環動畫 |
BounceLoop { duration: f64, end: f64 } | 彈跳循環動畫 |
緩動函數(Ease 列舉)
// 基本
Linear
// 二次方
InQuad, OutQuad, InOutQuad
// 三次方
InCubic, OutCubic, InOutCubic
// 四次方
InQuart, OutQuart, InOutQuart
// 五次方
InQuint, OutQuint, InOutQuint
// 正弦
InSine, OutSine, InOutSine
// 指數
InExp, OutExp, InOutExp
// 圓形
InCirc, OutCirc, InOutCirc
// 彈性
InElastic, OutElastic, InOutElastic
// 回彈
InBack, OutBack, InOutBack
// 彈跳
InBounce, OutBounce, InOutBounce
// 自訂
ExpDecay { d1: f64, d2: f64 }
Bezier { cp0: f64, cp1: f64, cp2: f64, cp3: f64 }
Pow { begin: f64, end: f64 }
使用緩動函數
from: {
all: Ease { duration: 0.3, ease: InOutQuad }
}
常見狀態
| 狀態 | 值 | 觸發條件 |
|---|---|---|
hover | on, off | 滑鼠進入/離開 |
pressed / down | on, off | 滑鼠按下/放開 |
focus | on, off | 取得/失去焦點 |
disabled | on, off | 元件啟用/停用 |
selected | on, off | 選取狀態變更 |
可動畫化的屬性
大多數 draw_* 著色器屬性都可以動畫化:
- 顏色:
color、border_color、shadow_color - 尺寸:
border_size、border_radius、shadow_radius - 變形:
scale、rotation、offset - 不透明度:
opacity
撰寫程式碼時的注意事項
- 始終為初始狀態設定
default: - 使用
Forward實現平滑過渡 - 使用
Snap實現即時狀態變更(如 disabled) - 保持較短的持續時間(0.1-0.3 秒)以獲得靈敏的反應
- 在
draw_bg、draw_text等中動畫化著色器屬性
Rust API(AnimatorImpl Trait)
pub trait AnimatorImpl {
// 播放至指定狀態
fn animator_play(&mut self, cx: &mut Cx, state: &[LiveId; 2]);
// 直接切換至狀態(無動畫)
fn animator_cut(&mut self, cx: &mut Cx, state: &[LiveId; 2]);
// 檢查目前狀態
fn animator_in_state(&self, cx: &Cx, state: &[LiveId; 2]) -> bool;
}
// 使用範例
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));
}
_ => {}
}
}
回答問題時的注意事項
- 狀態彼此獨立——可同時啟用多個狀態
- 當狀態達到指定值時,動畫會套用屬性
from定義如何動畫化,apply定義什麼要動畫化- Makepad 自動在舊值與新值之間進行補間
- 使用
id!(state.value)巨集在 Rust 中引用動畫狀態
限制
- 僅在任務明確符合上述範圍時使用此技能。
- 請勿將輸出視為環境特定驗證、測試或專家審查的替代品。
- 若缺少必要的輸入、權限、安全邊界或成功標準,請停止並請求釐清。