Makepad 動畫技能 是做什麼的?
版本: 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: "懸停我"
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實現流暢過渡 - 對即時狀態變更(如 disabled)使用
Snap - 保持較短時長(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)巨集來引用動畫狀態
限制
- 僅在任務明確符合上述範圍時使用此技能。
- 請勿將輸出視為環境特定驗證、測試或專家審查的替代品。
- 如果缺少必要的輸入、權限、安全邊界或成功標準,請停止並要求澄清。