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 は以下を行う必要があります:
- 上記の関連するリファレンスファイルを読む
- ファイルの読み取りに失敗した場合、またはファイルが空の場合:
- ユーザーに通知: 「ローカルドキュメントが不完全です。
/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 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 }
}
一般的な状態
| 状態 | 値 | トリガー |
|---|---|---|
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を使用する - レスポンシブな感覚を得るために、継続時間は短く(0.1〜0.3秒)保つ
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));
}
_ => {}
}
}
質問に答える際の注意点
- 状態は独立しており、複数の状態を同時にアクティブにできる
- アニメーションは状態がその値に達したときにプロパティを適用する
fromはアニメーションの方法を定義し、applyはアニメーションする内容を定義する- Makepad は古い値と新しい値の間を自動的にトゥイーンする
- Rust でアニメーション状態を参照するには
id!(state.value)マクロを使用する
制限事項
- このスキルは、タスクが上記で説明した範囲に明確に一致する場合にのみ使用すること
- 出力を環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないこと
- 必要な入力、権限、安全境界、または成功基準が欠けている場合は、立ち止まって質問すること