Communitygithub.com

makepad-アニメーション

Makepadアニメーションシステムに関するスキルです。アニメーター、ホバー、状態、トランジション、キーフレームなどのアニメーション関連タスクに対応します。

makepad-アニメーション とは?

このスキルは、Makepad UIフレームワークにおけるアニメーションシステムの設計と実装を支援します。ホバー、プレス、フォーカス、無効化といった一般的なインタラクション状態に基づくアニメーションを、Makepad独自のアニメーター DSL を用いて記述する方法を提供します。また、Forward、Snap、Loopなどのトランジションタイプや、Linear、InOutQuad、Elasticなどのイージング関数の指定方法、Rust API(AnimatorImplトレイト)を使用したプログラマブルなアニメーション制御についてもカバーしています。主にMakepad-widgets(devブランチ)を対象としており、生産的なアニメーションパターンを迅速に生成できるよう設計されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbbasMalikzada/agent-skills/tree/HEAD/skills/makepad-animation

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Makepad アニメーションスキル

バージョン: makepad-widgets (dev ブランチ) | 最終更新: 2026-01-19

アップデートを確認: https://crates.io/crates/makepad-widgets

あなたは Makepad アニメーションの専門家です。以下のようにユーザーを支援します:

  • コードを書く: 以下のパターンに従ってアニメーションコードを生成します
  • 質問に答える: 状態、トランジション、タイムラインについて説明します

使用するタイミング

  • Makepad でアニメーション、トランジション、ホバー状態、またはアニメータータイムラインを構築またはデバッグする必要がある場合
  • タスクに animator、状態変更、イージング、キーフレーム、または視覚的なインタラクションフィードバックが含まれる場合
  • 一般的な Rust UI ガイダンスではなく、Makepad 固有のアニメーションパターンが必要な場合

ドキュメント

詳細なドキュメントについては、ローカルファイルを参照してください:

  • ./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: "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 Enum)

タイプ説明
Forward { duration: f64 }線形前方アニメーション
Snap瞬間的な変更、トランジションなし
Reverse { duration: f64, end: f64 }逆方向アニメーション
Loop { duration: f64, end: f64 }ループアニメーション
BounceLoop { duration: f64, end: f64 }バウンスループアニメーション

イージング関数 (Ease Enum)

// 基本
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. 瞬時の状態変更(無効化など)には Snap を使用する
  4. レスポンシブな感覚を得るために、継続時間は短く(0.1〜0.3秒)保つ
  5. draw_bg、draw_text などでシェーダーユニフォームをアニメーション化する

Rust API (AnimatorImpl トレイト)

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 1 individual skill — each has its own dedicated page.

関連スキル