ウェブアニメーション設計
⚠️ クリエイティブパック — 自動適用されません
このスキルはクリエイティブパックの一部です。タスクが明示的にアニメーション、モーション、インタラクションのフィーリングに関わる場合に使用してください。一般的なUI構築ではロードしないでください。design-reviewのモーションリファレンスで基本的なモーション品質はカバーされています。
使用するケース: ユーザーがアニメーション、イージング、スプリング、トランジション、インタラクションのフィーリング、「スムーズにしたい」について質問した場合。 スキップするケース: design-reviewのモーションリファレンスで十分な標準的なUIを構築する場合。
Emil Kowalski の「Animations on the Web」コースに基づいた、適切なアニメーションを作成するための包括的なガイドです。
初回応答
このスキルが特定の質問なしで最初に呼び出された場合は、次のようにのみ応答してください。
Emil Kowalski の animations.dev コースに基づいてアニメーションのお手伝いをします。
ユーザーが質問するまで、これ以上の情報は提供しないでください。
レビュー形式 (必須)
アニメーションをレビューする際は、必ずMarkdownテーブルを使用してください。 「Before:」と「After:」を別々の行にリスト形式で記述しないでください。常に次のような実際のMarkdownテーブルを出力してください。
| Before | After |
|---|---|
transform: scale(0) | transform: scale(0.95) |
animation: fadeIn 400ms ease-in | animation: fadeIn 200ms ease-out |
| No reduced motion support | @media (prefers-reduced-motion: reduce) {...} |
間違った形式 (絶対にしないでください):
Before: transform: scale(0)
After: transform: scale(0.95)
────────────────────────────
Before: 400ms duration
After: 200ms
正しい形式: | Before | After | 列を持つ単一のMarkdownテーブル。問題ごとに1行。
決定木: どのツールを使うべきか?
これにはReactでのレイアウト変更、共有トランジション、終了アニメーションが含まれますか?
├── はい → Framer Motion (layoutアニメーション、AnimatePresence、layoutId)
│ インポート元 "motion/react" (NOT "framer-motion")
└── いいえ
├── 単純な入場/退場またはホバーですか? → CSSトランジション/キーフレーム
├── パフォーマンスが重要ですか (重いページ、多数の要素)? → CSS (ハードウェアアクセラレーション)
├── スプリング物理または割り込み可能性が必要ですか? → Framer Motion
├── ジェスチャートラッキング (ドラッグ、カーソル追従) が必要ですか? → FM motion values
└── 一定速度のループですか? → CSSキーフレーム
常に prefers-reduced-motion を確認してください。例外はありません。
クイックスタート
すべてのアニメーションの決定は、次の質問から始まります。
- この要素は入場または退場しますか? →
ease-outを使用 - 画面上の要素が動いていますか? →
ease-in-outを使用 - これはホバー/色のトランジションですか? →
easeを使用 - ユーザーはこれを毎日100回以上見ますか? → アニメーションさせない
イージング設計図
ease-out (最も一般的)
ユーザーが開始するインタラクションに使用: ドロップダウン、モーダル、ツールチップ、画面に入退場する要素。
/* 弱いものから強いものへ */
--ease-out-quad: cubic-bezier(0.25, 0.46, 0.45, 0.94);
--ease-out-cubic: cubic-bezier(0.215, 0.61, 0.355, 1);
--ease-out-quart: cubic-bezier(0.165, 0.84, 0.44, 1);
--ease-out-quint: cubic-bezier(0.23, 1, 0.32, 1);
--ease-out-expo: cubic-bezier(0.19, 1, 0.22, 1);
--ease-out-circ: cubic-bezier(0.075, 0.82, 0.165, 1);
なぜ機能するか: 開始時の加速により、瞬時の応答性が生まれます。要素が目的地に「ジャンプ」してから落ち着きます。
ease-in-out (動きに使用)
画面上に既にある要素が移動または変形する必要がある場合に使用。車が加速してからブレーキをかけるような自然な動きを模倣します。
/* 弱いものから強いものへ */
--ease-in-out-quad: cubic-bezier(0.455, 0.03, 0.515, 0.955);
--ease-in-out-cubic: cubic-bezier(0.645, 0.045, 0.355, 1);
--ease-in-out-quart: cubic-bezier(0.77, 0, 0.175, 1);
--ease-in-out-quint: cubic-bezier(0.86, 0, 0.07, 1);
--ease-in-out-expo: cubic-bezier(1, 0, 0, 1);
--ease-in-out-circ: cubic-bezier(0.785, 0.135, 0.15, 0.86);
ease (ホバー効果に使用)
ホバー状態と色のトランジションに使用。非対称なカーブ (開始が速く、終了が遅い) は、優しいアニメーションにエレガントに感じられます。
transition: background-color 150ms ease;
linear (UIでは避ける)
次の場合のみ使用:
- 一定速度のアニメーション (マーキー、ティッカー)
- 時間の視覚化 (長押し削除の進行状況インジケーター)
リニアはインタラクティブな要素に対してロボット的で不自然に感じられます。
ease-in (ほぼ使用しない)
UIアニメーションでは避けてください。 開始が遅いため視覚的なフィードバックが遅れ、インターフェースがもっさりした印象になります。
ペア要素ルール
一緒にアニメーションする要素は、同じイージングと継続時間を使用する必要があります。モーダル + オーバーレイ、ツールチップ + 矢印、ドロワー + 背景 — それらがユニットとして動く場合、ユニットとして感じられるべきです。
/* 両方が同じタイミングを使用 */
.modal {
transition: transform 200ms ease-out;
}
.overlay {
transition: opacity 200ms ease-out;
}
タイミングと継続時間
継続時間ガイドライン
| 要素タイプ | 継続時間 |
|---|---|
| マイクロインタラクション | 100-150ms |
| 標準UI (ツールチップ、ドロップダウン) | 150-250ms |
| モーダル、ドロワー | 200-300ms |
ルール:
- UIアニメーションは300ms未満に保つ
- 大きな要素は小さな要素よりも遅くアニメーションする
- 退場アニメーションは入場より約20%速くできる
- 距離に継続時間を合わせる - 移動距離が長いほど継続時間も長く
頻度
ユーザーがアニメーションを目にする頻度を判断します:
- 毎日100回以上 → アニメーションなし (または大幅に削減)
- たまに使用 → 標準アニメーション
- まれ/初回 → より特別にできる
例: Raycastはユーザーが1日に何百回も開くため、決してアニメーションしません。
いつアニメーションするか
アニメーションすべき場合:
- 空間的な一貫性のための入退場トランジション
- 視覚的な連続性が役立つ状態変化
- ユーザーアクションへの応答 (フィードバック)
- 喜びが価値を追加する、あまり使用されないインタラクション
アニメーションすべきでない場合:
- キーボードによるアクション
- 頻繁に使用される要素へのホバー効果
- ユーザーが毎日100回以上操作するもの
- 滑らかさよりも速度が重要な場合
マーケティング vs. プロダクト:
- マーケティング: より手の込んだ、より長い継続時間が許容される
- プロダクト: 高速で、目的があり、決して軽薄ではない
スプリングアニメーション
スプリングは固定の継続時間を持たず、実際の物理をシミュレートするため、より自然に感じられます。
スプリングを使用する場合
- 勢いのあるドラッグインタラクション
- 「生きている」ように感じさせる要素 (Dynamic Island)
- アニメーションの途中で割り込み可能なジェスチャー
- 有機的で遊び心のあるインターフェース
設定
Appleのアプローチ (推奨):
// 継続時間 + バウンス (理解しやすい)
{ type: "spring", duration: 0.5, bounce: 0.2 }
従来の物理:
// 質量、剛性、減衰 (より複雑)
{ type: "spring", mass: 1, stiffness: 100, damping: 10 }
バウンスガイドライン
- ほとんどのUIコンテキストではバウンスを避ける
- ドラッグして閉じる、遊び心のあるインタラクションにはバウンスを使用
- 使用する場合はバウンスを控えめに (0.1-0.3)
割り込み可能性
スプリングは割り込み時に速度を維持しますが、CSSアニメーションはゼロから再開します。これにより、スプリングはユーザーが動きの途中で変更する可能性のあるジェスチャーに理想的です。
レイアウトアニメーション (Framer Motion)
最も強力なFM機能。CSSでは不可能なプロパティをアニメーションできます: flex-direction、justify-content、位置の変更。
layout プロパティ
任意の motion.* 要素に layout を追加して、レイアウト変更を自動的にアニメーションします:
<motion.div layout className="element" />
この要素のサイズや位置が (状態、コンテンツ、兄弟要素によって) 変更されると、FMはそれをスムーズにアニメーションします。手動での測定は不要です。
共有レイアウトアニメーション (layoutId)
2つの別個の要素を接続して、一方が他方に変形するようにします:
// タブハイライト — アクティブなタブに対してのみレンダリング
{activeTab === tab ? (
<motion.div layoutId="tab-indicator" className="highlight" />
) : null}
使用例: タブハイライト、カード→モーダル展開、ボタン→ポップオーバー変形、ゴミ箱インタラクション (画像がコンテナ間を移動)。
クリエイティブなコツ: layoutId は錯覚を生み出します。フィードバックポップオーバーの「プレースホルダー」は、実際には共有 layoutId を持つ <span> です — 実際のテキストエリアのプレースホルダーではありません。ボタンテキストからポップオーバーテキストに変形します。
動的な高さのアニメーション
FMは auto から auto へのアニメーションができません。react-use-measure を使用します:
import useMeasure from "react-use-measure";
const [ref, bounds] = useMeasure();
<motion.div animate={{ height: bounds.height }}>
<div ref={ref}>{dynamicContent}</div>
</motion.div>
AnimatePresence (詳細)
モード
"sync"(デフォルト) — 入場と退場が同時に再生される"wait"— 退場が完了してから入場が開始される (コピー/チェックアイコンの切り替え)"popLayout"— 退場要素をレイアウトフローから即座に削除する (モーフィングUIでは多くの場合正しい選択)
方向認識トランジション
custom プロパティを使用して、退場コンポーネント (状態が古くなっている) に動的データを渡します:
<AnimatePresence mode="popLayout" custom={direction}>
<motion.div
key={step}
custom={direction}
initial="enter"
animate="center"
exit="exit"
variants={{
enter: (dir) => ({ x: dir > 0 ? 100 : -100, opacity: 0 }),
center: { x: 0, opacity: 1 },
exit: (dir) => ({ x: dir > 0 ? -100 : 100, opacity: 0 }),
}}
/>
</AnimatePresence>
主要ルール
- AnimatePresence内のアニメーション要素には常に
keyプロパティを追加する initial={false}を使用してマウントアニメーションをスキップする (アイコンの切り替え、ボタンの状態)- 既知のバグ: 高速切り替えで両方の要素が表示されることがある — 影響を受ける場合はFM v11.0.10に固定する
モーション値とフック
モーション値はReactのレンダリングサイクル外で更新されます — 再レンダリングなし、60fps。
useMotionValue — 即時更新 (ジェスチャー)
const x = useMotionValue(0);
// x.set(newValue) で更新、x.get() で読み取り
<motion.div style={{ x }} />
使用例: 直接的なジェスチャートラッキング (ドラッグ距離 → スケール)、スプリングの遅延が切断感を生むような1対1のマッピング。
useSpring — アニメーション更新 (フォロービハインド)
const x = useSpring(0, { mass: 0.1, damping: 16, stiffness: 71 });
// x.set(newValue) はスプリング物理でアニメーションする
使用例: カーソルフォロワー、モメンタム効果、入力の後を追従するもの。
useTransform — ある値を別の値にマッピングする
// 範囲マッピング: y位置 [0, 300] → スケール [1, 1.5]
const scale = useTransform(y, [0, 300], [1, 1.5]);
// 関数形式: 値のフォーマット
const display = useTransform(angle, v => `${Math.round(v)}°`);
使用例: スクロール連動効果、カーソル距離効果、値のフォーマット。
useMotionTemplate — モーション値による文字列補間
const clipPath = useMotionTemplate`inset(0px ${percent}% 0px 0px)`;
<motion.div style={{ clipPath }} />
MotionConfig — サブツリーのデフォルトトランジション
<MotionConfig transition={{ type: "spring", duration: 0.5, bounce: 0.2 }}>
{/* すべての子要素は、上書きされない限りこのトランジションを使用 */}
</MotionConfig>
オーケストレーション (スタガーとシーケンス)
スタガー入場アニメーションは波のような効果を生み出します。式はなく、試行錯誤で適切に感じられるまで調整します。
CSSスタガー (ライブラリなし):
.item { animation: fadeSlideIn 400ms ease-out both; }
.item:nth-child(1) { animation-delay: 0ms; }
.item:nth-child(2) { animation-delay: 50ms; }
.item:nth-child(3) { animation-delay: 100ms; }
/* 以下同様 */
FMスタガー:
const container = {
animate: { transition: { staggerChildren: 0.05 } }
};
const item = {
initial: { opacity: 0, y: 20 },
animate: { opacity: 1, y: 0 }
};
ルール:
- 遅延は小さく保つ (アイテム間30-80ms)
- 合計シーケンス時間を制限 — 10アイテムで各80msだと800ms、遅すぎる
- マーケティングページはより手の込んだものにできるが、プロダクトUIは高速にする
アニメーション速度によるブランド表現
アニメーションのタイミングはブランドアイデンティティです:
- スピードブランド (Vercel): 即座または非常に高速、最小限のイージング。「私たちはあなたの時間を無駄にしません。」
- プレミアムブランド (Stripe): より遅く、より意図的。エレガントさのために
easeカーブ (ease-outではない)。 - 遊び心のあるブランド (Family): 微妙なバウンス、流動的なモーフィングを備えたスプリング。
- プロダクトUI は一般的にブランドに関係なく高速に感じられるべきです。
- マーケティングページ は、モーションを通じてブランドの個性を表現する場所です。
流動的インターフェース (目標)
究極の目標: 何も「現れたり」「消えたり」しない — すべてがモーフィングする。Family (iOS) がゴールドスタンダードです。
- 共有レイアウトアニメーションは、ネイティブの流動性に最も近いウェブのツールです
- 流動的なモーションは知覚パフォーマンスを向上させます (同じ読み込み時間でもより速く感じられる)
- UIをデザインする前にアニメーションについて考える — シームレスなトランジションを可能にするように要素を配置する
- 現在ウェブでは難しいですが、すべての方向性が向かっているところです
- テキストモーフィング (例: ボタンラベルの変更) は状態変化をさりげなく強調します
パフォーマンス
黄金律
transform と opacity のみをアニメーションします。これらはレイアウトとペイントの段階をスキップし、完全にGPU上で実行されます。
アニメーションを避けるもの:
padding、margin、height、width(レイアウトをトリガー)- 20pxを超える
blurフィルター (特にSafariで負荷が高い) - 深いコンポーネントツリー内のCSS変数
最適化テクニック
/* GPUアクセラレーションを強制 */
.animated-element {
will-change: transform;
}
React固有:
- 可能な場合はReactのレンダリングサイクル外でアニメーションする
- stateの代わりにrefを使用してスタイルを直接更新する
- 毎フレームの再レンダリング = フレーム落ち
Framer Motion:
// ハードウェアアクセラレーション (transformを文字列として)
<motion.div animate={{ transform: "translateX(100px)" }} />
// ハードウェアアクセラレーションではない (より読みやすい)
<motion.div animate={{ x: 100 }} />
CSS vs. JavaScript
- CSSアニメーションはメインスレッド外で実行される (負荷時によりスムーズ)
- JSアニメーション (Framer Motion、React Spring) は
requestAnimationFrameを使用 - CSSはシンプルで事前定義されたアニメーションに適している
- JSは動的で割り込み可能なアニメーションに適している
- 両方を組み合わせる: CSSはシンプル/パフォーマンス重視のアニメーションに、FMは複雑/レイアウト/スプリングに
CSS変数の落とし穴
CSS変数は...