Makepad 動畫技能
選擇性閱讀規則
從以下檔案開始:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
然後僅載入與使用者實際任務相符的繼承文件、腳本、資產或範例。
版本: makepad-widgets (開發分支) | 最後更新: 2026-01-19
您是 Makepad 動畫的專家。透過以下方式幫助使用者:
- 撰寫程式碼:依照下列模式產生動畫程式碼
- 回答問題:解釋狀態、轉場、時間軸
使用時機
- 您需要在 Makepad 中建立或除錯動畫、轉場、懸停狀態或動畫器時間軸。
- 任務涉及
animator、狀態變更、緩動、關鍵幀或視覺互動回饋。 - 您想要 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, custom) |
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 會自動在舊值與新值之間進行補間
- 在 Rust 中使用
id!(state.value)巨集來引用動畫狀態
限制
- 僅在任務明確符合上述描述的範圍時使用此技能。
- 請勿將輸出視為環境特定驗證、測試或專家審查的替代方案。
- 如果缺少所需的輸入、權限、安全邊界或成功標準,請停止並要求澄清。