Communitygithub.com

Makepad 動畫技能

用於 Makepad 動畫系統。觸發條件:makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed 等關鍵詞。

Makepad 動畫技能 是什麼?

此技能提供 Makepad UI 框架中動畫系統的完整指導與程式碼生成能力。它涵蓋了動畫器的核心概念,包括狀態定義(hover、pressed、focus、disabled 等)、時間軸類型(Forward、Snap、Reverse、Loop、BounceLoop)以及豐富的緩動函數(從基本的 Linear 到彈性、彈跳和貝塞爾曲線)。開發者可以使用此技能快速建構互動式 UI 動畫,例如按鈕懸停效果、多狀態複合動畫(同時處理 hover 和 pressed 狀態)、焦點邊框變化以及禁用狀態的即時切換。技能支援 makepad-widgets 套件(開發分支),並提供 Rust 的 AnimatorImpl trait 程式碼範例,讓開發者能透過 animator_play、animator_cut 等 API 在事件處理中驅動動畫。文件中還包含完整的可動畫屬性列表(顏色、大小、變換、透明度)以及實用的編碼建議,如保持動畫時長在 0.1-0.3 秒以獲得靈敏的回饋。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlperTuncOrtak/crypto-data-pipeline/tree/HEAD/skills/makepad-animation

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Makepad 動畫技能 是做什麼的?

版本: makepad-widgets(開發分支)| 最後更新: 2026-01-19

檢查更新:https://crates.io/crates/makepad-widgets

您是 Makepad 動畫專家。透過以下方式協助使用者:

  • 撰寫程式碼:按照以下模式產生動畫程式碼
  • 回答問題:解釋狀態、過渡、時間軸

使用時機

  • 您需要在 Makepad 中建立或除錯動畫、過渡、懸停狀態或動畫時間軸。
  • 任務涉及 animator、狀態變更、緩動、關鍵影格或視覺互動回饋。
  • 您需要 Makepad 專用的動畫模式,而非通用的 Rust UI 指引。

文件

請參閱本機檔案以取得詳細文件:

  • ./references/animation-system.md - 完整動畫參考

進階模式

如需生產就緒的動畫模式,請參閱 _base/ 目錄:

模式說明
06-animator-basics動畫器基礎
07-easing-functions緩動與時序
08-keyframe-animation複雜關鍵影格

重要:文件完整性檢查

在回答問題之前,Claude 必須:

  1. 讀取上面列出的相關參考檔案
  2. 如果檔案讀取失敗或檔案為空:
    • 告知使用者:「本地文檔不完整,建議運行 /sync-crate-skills makepad --force 更新文檔」
    • 仍然根據 SKILL.md 模式 + 內建知識回答
  3. 如果參考檔案存在,將其內容納入回答

關鍵模式

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 }
}

常見狀態

狀態值觸發條件
hoveron, off滑鼠進入/離開
pressed / downon, off滑鼠按下/放開
focuson, off取得/失去焦點
disabledon, off啟用/停用小工具
selectedon, off選擇變更

可動畫屬性

多數 draw_* 著色器統一變數可以動畫化:

  • 顏色:color、border_color、shadow_color
  • 尺寸:border_size、border_radius、shadow_radius
  • 變換:scale、rotation、offset
  • 不透明度:opacity

撰寫程式碼時

  1. 務必為初始狀態設定 default:
  2. 使用 Forward 實現流暢過渡
  3. 對即時狀態變更(如 disabled)使用 Snap
  4. 保持較短時長(0.1-0.3 秒)以獲得靈敏回饋
  5. 在 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));
        }
        _ => {}
    }
}

回答問題時

  1. 狀態彼此獨立——多個狀態可以同時處於活躍狀態
  2. 當狀態達到某個值時,動畫會套用屬性
  3. from 定義如何動畫,apply 定義動畫什麼
  4. Makepad 會自動在舊值與新值之間進行補間
  5. 在 Rust 中使用 id!(state.value) 巨集來引用動畫狀態

限制

  • 僅在任務明確符合上述範圍時使用此技能。
  • 請勿將輸出視為環境特定驗證、測試或專家審查的替代品。
  • 如果缺少必要的輸入、權限、安全邊界或成功標準,請停止並要求澄清。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

AlperTuncOrtak/crypto-data-pipeline

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

AlperTuncOrtak/crypto-data-pipeline

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

AlperTuncOrtak/crypto-data-pipeline

One sentence - what this skill does and when to invoke it

AlperTuncOrtak/crypto-data-pipeline

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlperTuncOrtak/crypto-data-pipeline

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

AlperTuncOrtak/crypto-data-pipeline

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

AlperTuncOrtak/crypto-data-pipeline

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

AlperTuncOrtak/crypto-data-pipeline

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

AlperTuncOrtak/crypto-data-pipeline

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

AlperTuncOrtak/crypto-data-pipeline

Best practices for Remotion - Video creation in React

AlperTuncOrtak/crypto-data-pipeline

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

AlperTuncOrtak/crypto-data-pipeline

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

AlperTuncOrtak/crypto-data-pipeline

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

AlperTuncOrtak/crypto-data-pipeline

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

AlperTuncOrtak/crypto-data-pipeline

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

AlperTuncOrtak/crypto-data-pipeline

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

AlperTuncOrtak/crypto-data-pipeline

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

AlperTuncOrtak/crypto-data-pipeline

One sentence - what this skill does and when to invoke it

AlperTuncOrtak/crypto-data-pipeline

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

AlperTuncOrtak/crypto-data-pipeline

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

相關技能