アニメーションの構築
このリポジトリ (Asymmetric-al/core)
このスキルは、Core のデザインエンジニアリングおよび動作中のモーション契約に従った Web モーションを実装するために使用します。アップストリームの更新後、bun run skills:sync を実行する前に、このオーバーレイを調整してください。
トリガー
- Web アニメーション、トランジション、またはマイクロインタラクションの構築または書き換え。
- Expo/React Native (
animate-expo)、コードベース監査 (improve-animations)、または厳格なモーションのみのレビュー (review-animations) には使用しないでください。
ワークフロー
- 最初に
docs/ai/skills/emil-design-engineering/SKILL.mdとdocs/ai/skills/anim/SKILL.mdを読み込んでください。 - 既存の Core モーショントークンと Base UI プリミティブを再利用してください。持続時間、イージングをフォークしたり、Radix API を導入したりしないでください。
- 縮小モーションは
packages/ui/styles/globals.cssのグローバルベースラインに維持してください。 - タスクにトースト、ドロワー、メニュー、またはドロップダウンが必要な場合は、
@asym/ui/ Base UI を再利用してください。ユーザーが明示的にどのライブラリを使用するか尋ねない限り、pick-ui-libraryを呼び出さないでください。
チェックリスト
- アニメーションには目的があり、可能な限り
transform/opacityに留まっている。 - Core トークン、Base UI、
animが、説明用のアップストリーム値よりも優先されている。 - 共有ユーティリティと
@asym/lib/motion-presetsが、新しいタイミングリテラルよりも優先されている。
構築スキルです。これは 1 つのことだけを行います: モーションのリクエストを、厳格なレビューに耐える実装に変換することです。コードベースの監査 (improve-animations)、差分の批評 (review-animations)、アニメーション化できる場所の検索 (find-animation-opportunities)、React Native 向けの構築 (animate-expo) は行いません。
動作姿勢
あなたは自分自身でアニメーションを構築するシニアデザインエンジニアです。基準は Emil Kowalski のアニメーション哲学 — review-animations が強制するのと同じ基準です。初回でそのレビューに合格するようにコードを書いてください。
2 つの失敗モードがあり、最初のものがより悪質です:
- アニメーション化すべきでないものをアニメーション化する。 以下のゲートは、時にはゼロ行のコードを生成するために存在します。それは回避ではなく成功です。
- 正しいものを誤った材料でアニメーション化する — エントランスに
ease-in、scale(0)、トーストにキーフレーム、ドロップダウンを遅く感じさせる持続時間。
モーションオプションをメニューとして提示しないでください。決定を下し、理由を 1 行で述べ、コードを書いてください。
ハードルール
- シーケンスを順番に実行してください。 ステップ 1 と 2 がすべてをゲートします。アニメーション化するかどうかを知る前にカーブに手を伸ばさないでください。
- 近似値は禁止。 すべてのカーブ、持続時間、スプリング設定は以下のテーブルから取得します。
cubic-bezier(0.4, 0, 0.2, 1)を馴染みがあるからといって発明しないでください。 - コードベースのトークンを拡張し、フォークしないでください。
--ease-out-softや持続時間トークンがpackages/ui/styles/globals.cssに既に存在する場合は、それを使用してください。並列システムを追加することは欠陥です。 - 縮小モーションとホバーゲートはアニメーションと共に出荷され、フォローアップとしてではありません。
- 機能する最も低コストのツール。 フェードのためにモーションライブラリをインストールしないでください。
ビルドシーケンス
1. これはアニメーション化すべきか?
| 頻度 | 決定 |
|---|---|
| 1 日 100 回以上 (キーボードショートカット、コマンドパレットの切り替え) | アニメーション禁止。絶対に。 ここで停止。 |
| 1 日数十回 (ホバー効果、リストナビゲーション) | ほぼ知覚できないもののみ — 高速かつ控えめ、またはなし |
| たまに (モーダル、ドロワー、トースト) | 標準的なアニメーション |
| 稀 / 初回 (オンボーディング、成功、祝福) | ここに Delight 予算が存在する |
キーボードによって開始されるアクションは、判断の余地がなく、失格の理由になります。 Raycast には開閉アニメーションがありません — それは 1 日に何百回も開かれるものにとって正しいことです。
リクエストがこのゲートに失敗した場合は、その旨を明確に述べ、アニメーションを書かないでください。代わりに、モーションなしの代替案 (即時状態変更、静的なアフォーダンス) を提案してください。
2. 目的は何か?
続行する前に、以下の単語のいずれかで名前を付けてください:
- フィードバック — インターフェースがユーザーの入力を認識したことを確認する
- 空間的一貫性 — 何かがどこから来たのか、どこへ行ったのかを示す
- 状態表示 — 状態変化を読み取り可能にする
- 急激な変化の防止 — そうでなければテレポートするコンテンツを橋渡しする
- 説明 — 何かがどのように機能するかを示す (マーケティング/オンボーディングのみ)
- Delight — 稀/初回の階層でのみ許可
名前を付けられない? 構築しないでください。頻繁に見られる要素での「見た目がかっこいい」は停止する理由です。
また、機能を確認してください: ユーザーが読んでいる、または操作しているデータは、スタイルのために動くべきではありません。装飾的なマウストラッキング効果は、銀行アプリのグラフではなく、マーケティングページに属します。
3. ツールを選択 — 機能する最も低コストのもの
下に向かって進み、最初に適合するもので停止してください。
| ニーズ | ツール |
|---|---|
| ホバー、プレス、色、クラスや属性で制御する状態トグル | CSS トランジション |
| マウント時のエントリアニメーション、JS 状態なし | CSS @starting-style |
| ページが読み込み中でもスムーズさを保つ必要がある所定のモーション | CSS アニメーション (メインスレッド外で実行) |
| CSS パフォーマンスを備えたプログラム制御、ライブラリ不要 | WAAPI (element.animate()) |
| スプリング、レイアウトアニメーション、終了アニメーション、ジェスチャ駆動の値 | Motion (motion.dev) |
CSS アニメーションは負荷時に JS よりも優れています — メインスレッド外で実行される一方、requestAnimationFrame ベースのアニメーションはブラウザが読み込み、スクリプト実行、または描画中にフレームをドロップします。所定のモーションには CSS を、動的で割り込み可能なモーションには JS を使用してください。
タスクにアニメーションではなくコンポーネント — トースト、ドロワー、コマンドメニュー、ドロップダウン — が必要な場合は、@asym/ui と Base UI を再利用してください。ユーザーが明示的にどのライブラリを使用するか尋ねない限り、pick-ui-library を呼び出さないでください。これらを手作りすると、<div> ドロップダウンでフォーカス管理がない状態になりかねません。
4. プロパティを選択
transformとopacityのみ。 これらはレイアウトとペイントをスキップし、GPU 上で実行されます。width/height/margin/padding/top/leftは 3 つすべてをトリガーします。(clip-pathは認可された 4 つ目です — RECIPES.md を参照。heightは、変換相当がないアコーディオンの場合にのみ許容されます。)scale(0)は絶対に禁止。scale(0.9–0.97)+opacity: 0から始めてください。現実世界で何もないところから現れるものはありません。- ポップオーバー、ドロップダウン、メニュー、ツールチップのトリガーに
transform-origin— Base UI のvar(--transform-origin)。モーダルは例外です。これらはトリガーにアンカーされていないため、中央に留まります。 translate()のパーセンテージは要素自身のサイズに対する相対値です —translateY(100%)は内容に関係なく自身の高さ分だけ移動します。ハードコードされたピクセルよりも優先してください。- Motion では、
x、y、scaleは独立した変換としてサポートされています。 これらはパフォーマンスが高いです。メインスレッドがビジーな間もアニメーションをコンポジター上に保つ必要がある場合にのみ、完全なtransform文字列を使用してください:
<motion.div animate={{ x: 100 }} />
<motion.div animate={{ transform: "translateX(100px)" }} />
- 親の CSS 変数から子の transform を駆動しないでください — すべての子のスタイルを再計算します。
transformは要素に直接設定してください。
5. イージングと持続時間 — またはスプリング
イージング、決定順:
| 状況 | イージング |
|---|---|
| 出入り | ease-out |
| 画面上での移動 / 変形 | ease-in-out |
| ホバー / 色変更 | ease |
| 一定のモーション (マーキー、プログレス) | linear |
| デフォルト | ease-out |
UI に ease-in は絶対に禁止。 それはゆっくり始まり、ユーザーが見ているまさにその瞬間を遅らせます。200ms の ease-out は、200ms の ease-in よりも速く感じられます。
組み込みの CSS イージングは弱すぎます。これらを使用してください:
--ease-out-soft: cubic-bezier(
0.22,
1,
0.36,
1
); /* Core トークン; UI 用の強い ease-out */
--ease-in-out-soft: cubic-bezier(
0.77,
0,
0.175,
1
); /* 画面上の動き用の強い ease-in-out */
--ease-drawer: cubic-bezier(
0.32,
0.72,
0,
1
); /* iOS ライクなドロワー曲線 (Ionic) */
ここにないカーブが必要ですか? easing.dev または easings.co から取得してください。手作りしないでください。
持続時間:
| 要素 | 持続時間 |
|---|---|
| ボタンプレスフィードバック | var(--duration-press) (120ms) |
| ツールチップ、小さなポップオーバー | var(--duration-micro) (150ms) |
| ドロップダウン、セレクト | var(--duration-standard) (220ms) |
| モーダル | var(--duration-modal) (220ms) |
| ドロワー | var(--duration-drawer) (320ms) |
| マーケティング / 説明用 | より長くても可 |
UI アニメーションは 300ms 未満に保ってください。 180ms のドロップダウンは、400ms のものよりも応答性が高く感じられます。
代わりにスプリングに手を伸ばしてください モーションが勢いのあるドラッグ、生きているように感じさせるべき要素、ユーザーが割り込んだり逆転させたりできるジェスチャー、または装飾的なマウストラッキングの場合:
{ type: "spring", duration: 0.5, bounce: 0.2 } // Apple スタイル — 推論しやすい
{ type: "spring", mass: 1, stiffness: 100, damping: 10 } // 伝統的な物理 — より制御性が高い
バウンスは 0.1–0.3 に保ち、ほとんどの UI ではバウンスを避けてください — ドラッグして閉じる操作と遊び心のあるインタラクションのために予約してください。
6. 割り込みと終了
- 急激にトリガーされるものには、キーフレームではなくトランジション — トースト、トグル、ユーザーが 1 秒間に 2 回発火できるものすべて。トランジションは現在の値から再ターゲットします。キーフレームはゼロから再起動します。
- ジェスチャーにはスプリング、割り込みを通じて速度を運ぶため。
- 入った方法と同じように終了します。 下からスライドインするトーストは、下から出て行きます。対称的なパスが、スワイプして閉じる操作を直感的に感じさせます。
- ユーザーが決定している場所では非対称なタイミング。 意図的なフェーズではゆっくり (確認のための長押し: 2s リニア)、システム応答では素早く (解放: 200ms ease-out)。
7. 縮小モーションとポインターゲート
毎回、アニメーションと共に出荷されます。
@media (prefers-reduced-motion: reduce) {
.element {
animation: fade 0.2s ease;
} /* opacity/color は維持、transform ベースのモーションは削除 */
}
@media (hover: hover) and (pointer: fine) {
.element:hover {
transform: scale(1.05);
} /* タッチはタップ時に誤ったホバーを発火させる */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : "-100%";
縮小モーションとは、より少なく、より穏やかなアニメーションを意味し、ゼロではありません — 理解を助けるトランジションは維持し、移動と位置の変更は削除してください。
レシピ
一般的なケース — ボタンプレス、ドロップダウン、ツールチップ、モーダル、ドロワー、トースト、アコーディオン、スタガー、確認の長押し、タブインジケーター、スクロールリビール、ドラッグして閉じる — の実装準備が整ったものについては、RECIPES.md を参照してください。リクエストがそれらのコンポーネントのいずれかに一致する場合はいつでもロードし、空白のファイルからではなくレシピから始めてください。
絶対に出荷禁止
終了前に自己チェックしてください。以下の各項目は、review-animations で自動的にブロックされます:
| 絶対に禁止 | 代わり |
|---|---|
transition: all | 正確なプロパティを指定 |
transform: scale(0) エントリー | scale(0.95) + opacity: 0 |
UI 要素での ease-in | ease-out または強いカスタム曲線 |
意図的なアニメーションでの組み込み ease-out | cubic-bezier(0.23, 1, 0.32, 1) |
| キーボードショートカットまたは 1 日 100 回以上のアクションでのアニメーション | アニメーションなし |
| 理由なく 300ms を超える UI 持続時間 | 150–250ms |
トリガーにアンカーされたポップオーバーでの transform-origin: center | var(--transform-origin) (モーダルは例外) |
| トースト、トグル、急激にトリガーされる要素でのキーフレーム | CSS トランジション |
width/height/margin/padding/top/left のアニメーション | transform / opacity |
負荷時の Motion x/y/scale プロップ | 完全な transform 文字列 |
ゲートされていない :hover モーション | @media (hover: hover) and (pointer: fine) |
prefers-reduced-motion の欠落 | より穏やかなバリアント、ゼロではない |
| すべてが一度に入ってくる | 30–80ms のスタガー |
出力
コードを書いてください。その後、最大で数行:
- ゲート結果 — 頻度階層と名前付き目的。リクエストの何かが拒否された場合は、どれとその理由を述べてください。
- 材料 — ツール、プロパティ、カーブ、持続時間またはスプリング設定、それぞれ 1 行ずつ。
- フィールチェックすべき点 — 結果がコードから判断できないフィールに依存する場合 (クロスフェード、スプリングのバウンス、入力リスト内の opacity/height バランス)、その旨を述べ、チェックを指示してください: 2~5 倍の持続時間または DevTools アニメーションインスペクターで再生し、フレームごとにステップ実行し、実際のデバイスでジェスチャーをテストし、翌日もう一度確認してください。