Makepadアニメーションスキル は何をしますか?
バージョン: makepad-widgets (devブランチ) | 最終更新: 2026-01-19
あなたは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: "ホバーミー"
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を使用する - 即時状態変更(無効など)には
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)マクロを使用する
制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用すること。
- 出力を環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないこと。
- 必要な入力、権限、安全境界、成功基準が不足している場合は、停止して明確化を求めること。