このスキルが有効になったら、最初の応答を必ず 🧢 の絵文字で始めてください。
モーションデザイン
Webアプリケーションでアニメーションとモーションを実装するための、焦点を絞った確固たる知識ベースです。CSSトランジションとキーフレーム、Framer Motion、GSAP、スクロール駆動アニメーション、マイクロインタラクションをカバーし、各パターンに具体的なコードを提供します。すべての推奨事項は、60fpsのパフォーマンス、アクセシビリティ、装飾ではなく目的のある動きを優先します。
良いアニメーションと悪いアニメーションの違いは抑制です。ほとんどのUIは、より多くのアニメーションではなく、より少ないアニメーションを必要とします。モーションが存在する場合、それは高速で、スムーズで、ユーザーの設定を尊重するものでなければなりません。
このスキルを使用するタイミング
以下の場合にこのスキルを起動します:
- ユーザーがUI要素にアニメーションやトランジションを追加したい場合
- コンポーネントのマウント/アンマウント時の出入りアニメーションが必要な場合
- ページトランジションやルート変更アニメーションを実装したい場合
- Framer Motion、GSAP、またはCSSアニメーションAPIについて質問された場合
- スクロール駆動アニメーションやパララックス効果が必要な場合
- スケルトンスクリーンやスピナーを使ったローディング状態が必要な場合
- スプリング物理、イージングカーブ、またはアニメーションのタイミングについて質問された場合
- 複雑なマルチステップシーケンスのためのGSAPタイムラインが必要な場合
- マイクロインタラクション(ホバー、プレス、トグル、チェックボックスの状態)について質問された場合
以下の場合はこのスキルを起動しないでください:
- モーションのない純粋なCSSレイアウトやスタイリング(代わりにultimate-uiを使用)
- CanvasやWebGLレンダリング(代わりにグラフィック固有のリソースを使用)
主要な原則
-
モーションには目的が必要 - すべてのアニメーションは何かを伝える必要があります:状態の変化、空間的な関係、フィードバック、または階層。装飾だけのモーションはノイズです。追加する前に「このアニメーションはユーザーに何を伝えるのか?」と自問してください。
-
prefers-reduced-motionを尊重する - 常にprefers-reduced-motionチェックでアニメーションをラップしてください。前庭障害やてんかんを持つユーザーは、モーションによって害を受ける可能性があります。これは提案ではなく、WCAG 2.1 AAの要件です。 -
transformとopacityのみをアニメーション化する -
transformとopacityは、ブラウザがコンポジタースレッド上でレイアウトやペイントをトリガーせずにアニメーション化できる唯一のプロパティです。width、height、top、left、margin、paddingをアニメーション化すると、ジャンクが発生します。代わりにtransform: scale/translateを使用してください。 -
スプリング > リニアイージング - 自然な動きは、均一な速度ではなく物理ベースのイージングを使用します。スプリングアニメーションは生き生きと感じられます。
linearはロボットのように感じられます。エントランスにはease-out、エグジットにはease-in、ユーザー入力に応答するインタラクティブ要素にはスプリング/バウンスを使用してください。 -
60fps以上か、または何もしない - アニメーションがフレームをドロップする場合は、削除してください。カクカクしたアニメーションは、アニメーションがないよりも悪いです。CPUをスロットリングしてテストしてください(Chrome DevToolsで4倍スローダウン)。60fpsを下回る場合は、簡略化するかカットしてください。
コアコンセプト
アニメーションプロパティ
- 持続時間:マイクロ(ボタンホバー)には100〜150ミリ秒、UI(モーダル、ドロップダウン)には200〜300ミリ秒、レイアウト(ページトランジション)には300〜500ミリ秒。インタラクティブなフィードバックでは500ミリ秒を超えないでください。
- イージング:画面に入る要素には
ease-out(速いスタート、ソフトランディング)。画面から出る要素にはease-in(遅いスタート、速い終了)。画面を横切って移動する要素にはease-in-out。インタラクティブ/遊び心のある要素にはスプリング。 - ディレイ:控えめに使用してください。子要素のスターガーは最大50〜75ミリ秒。スターガーシーケンスの合計は、ユーザーが待たされていると感じないように400ミリ秒を超えないようにしてください。
CSS vs JSアニメーション - 決定ガイド
- CSSトランジションは、クラスや疑似クラス(ホバー、フォーカス、アクティブ)によってトリガーされる単純な状態変更に使用します。JSのオーバーヘッドはゼロです。
- CSSキーフレームは、ループアニメーション(スピナー、パルス)や、インタラクションに関連しない振り付けされたシーケンスに使用します。
- Framer Motion(React)は、コンポーネントのマウント/アンマウントに伴う出入りアニメーション、ジェスチャー駆動のモーション、またはレイアウトアニメーションに使用します。
- GSAPは、複雑なマルチステップタイムライン、SVGパスアニメーション、スクロールトリガーシーケンス、または正確なプログラム制御が必要な場合に使用します。
スプリング物理
スプリングには2つの主要なパラメータがあります:stiffness(加速の速さ)とdamping(落ち着く速さ)。高stiffness+高damping=スナッピー。低stiffness+低damping=バウンシーで遅い。UIの場合:stiffness 300〜500、damping 25〜35で、過度なバウンスなしに自然な感触が得られます。
パフォーマンス - コンポジタースレッド vs メインスレッド
ブラウザは2段階でレンダリングします:メインスレッド(レイアウト、ペイント)とコンポジタースレッド(transform、opacity)。コンポジタースレッド上のアニメーションは、メインスレッドがビジーな場合でも60fpsで実行されます。常にtransformとopacityを使用してください。アニメーション化することがわかっている要素にのみwill-change: transformを追加してください。will-changeを使いすぎるとGPUメモリを浪費します。
一般的なタスク
CSSトランジションとキーフレーム
/* 再利用可能なイージングトークン */
:root {
--ease-out: cubic-bezier(0, 0, 0.2, 1);
--ease-in: cubic-bezier(0.4, 0, 1, 1);
--ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
--ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
--duration-fast: 100ms;
--duration-normal: 200ms;
--duration-slow: 300ms;
}
/* フェードインアップ - 表示されるコンテンツ */
@keyframes fade-in-up {
from { opacity: 0; transform: translateY(12px); }
to { opacity: 1; transform: translateY(0); }
}
/* スケールイン - モーダル、ポップオーバー */
@keyframes scale-in {
from { opacity: 0; transform: scale(0.95); }
to { opacity: 1; transform: scale(1); }
}
.modal {
animation: scale-in var(--duration-normal) var(--ease-out);
}
/* カードホバー - リフト効果 */
.card {
transition: transform var(--duration-fast) var(--ease-out),
box-shadow var(--duration-fast) var(--ease-out);
}
.card:hover {
transform: translateY(-2px);
box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
}
Framer Motionの出入りアニメーション
import { motion, AnimatePresence } from 'framer-motion';
// 再利用可能なアニメーションバリアント
const fadeUp = {
initial: { opacity: 0, y: 12 },
animate: { opacity: 1, y: 0 },
exit: { opacity: 0, y: -8 },
transition: { duration: 0.2, ease: [0, 0, 0.2, 1] },
};
const scaleIn = {
initial: { opacity: 0, scale: 0.95 },
animate: { opacity: 1, scale: 1 },
exit: { opacity: 0, scale: 0.95 },
transition: { duration: 0.15, ease: [0, 0, 0.2, 1] },
};
// 出入りアニメーションのあるコンポーネント
function Notification({ show, message }: { show: boolean; message: string }) {
return (
<AnimatePresence>
{show && (
<motion.div
key="notification"
{...fadeUp}
className="toast"
>
{message}
</motion.div>
)}
</AnimatePresence>
);
}
// スターガーリスト
function AnimatedList({ items }: { items: string[] }) {
return (
<motion.ul
initial="hidden"
animate="visible"
variants={{
hidden: {},
visible: { transition: { staggerChildren: 0.06 } },
}}
>
{items.map((item) => (
<motion.li
key={item}
variants={{
hidden: { opacity: 0, x: -12 },
visible: { opacity: 1, x: 0, transition: { duration: 0.2 } },
}}
>
{item}
</motion.li>
))}
</motion.ul>
);
}
CSSによるスクロール駆動アニメーション
/* ネイティブCSSスクロール駆動アニメーション(Chrome 115+) */
@keyframes reveal {
from { opacity: 0; transform: translateY(20px); }
to { opacity: 1; transform: translateY(0); }
}
.scroll-reveal {
animation: reveal linear both;
animation-timeline: view();
animation-range: entry 0% entry 25%;
}
/* ページスクロールに連動するプログレスバー */
.scroll-progress {
position: fixed;
top: 0;
left: 0;
height: 3px;
background: var(--color-primary-500);
transform-origin: left;
animation: scaleX linear;
animation-timeline: scroll(root);
}
@keyframes scaleX {
from { transform: scaleX(0); }
to { transform: scaleX(1); }
}
/* より広いブラウザサポートのためのIntersectionObserverフォールバック */
// IntersectionObserver - すべてのブラウザで動作
const observer = new IntersectionObserver(
(entries) => {
entries.forEach((entry) => {
if (entry.isIntersecting) {
entry.target.classList.add('in-view');
observer.unobserve(entry.target); // 1回だけアニメーション
}
});
},
{ threshold: 0.15 }
);
document.querySelectorAll('[data-reveal]').forEach((el) => observer.observe(el));
[data-reveal] {
opacity: 0;
transform: translateY(16px);
transition: opacity 0.3s var(--ease-out), transform 0.3s var(--ease-out);
}
[data-reveal].in-view {
opacity: 1;
transform: translateY(0);
}
AnimatePresenceによるページトランジション
import { AnimatePresence, motion } from 'framer-motion';
import { usePathname } from 'next/navigation';
const pageVariants = {
initial: { opacity: 0, y: 8 },
animate: { opacity: 1, y: 0, transition: { duration: 0.25, ease: [0, 0, 0.2, 1] } },
exit: { opacity: 0, y: -8, transition: { duration: 0.15, ease: [0.4, 0, 1, 1] } },
};
export function PageTransition({ children }: { children: React.ReactNode }) {
const pathname = usePathname();
return (
<AnimatePresence mode="wait">
<motion.div key={pathname} {...pageVariants}>
{children}
</motion.div>
</AnimatePresence>
);
}
新しいページが入る前に、出て行くページが完全にアニメーションアウトするように
mode="wait"を使用してください。mode="sync"(デフォルト)はオーバーラップを引き起こす可能性があります。ページトランジションは250ミリ秒未満に保ってください。ユーザーは新しいコンテンツを見るのを待っています。
マイクロインタラクション - ホバー、プレス、トグル
import { motion } from 'framer-motion';
// プレスフィードバック付きボタン
function Button({ children, onClick }: React.ComponentProps<'button'>) {
return (
<motion.button
whileHover={{ scale: 1.02 }}
whileTap={{ scale: 0.97 }}
transition={{ type: 'spring', stiffness: 500, damping: 30 }}
onClick={onClick}
>
{children}
</motion.button>
);
}
// アニメーショントグルスイッチ (CSS)
.toggle {
position: relative;
width: 44px;
height: 24px;
background: var(--color-gray-300);
border-radius: 12px;
transition: background 150ms var(--ease-in-out);
cursor: pointer;
}
.toggle[aria-checked="true"] {
background: var(--color-primary-500);
}
.toggle::after {
content: '';
position: absolute;
top: 2px;
left: 2px;
width: 20px;
height: 20px;
border-radius: 50%;
background: white;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.2);
transition: transform 200ms var(--ease-spring);
}
.toggle[aria-checked="true"]::after {
transform: translateX(20px);
}
/* grid-template-rowsトリックを使ったアコーディオン */
.accordion-content {
display: grid;
grid-template-rows: 0fr;
transition: grid-template-rows 200ms var(--ease-out);
}
.accordion-content[data-open="true"] {
grid-template-rows: 1fr;
}
.accordion-content > div {
overflow: hidden;
}
複雑なシーケンスのためのGSAPタイムライン
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);
// ヒーローエントランスシーケンス
function animateHero() {
const tl = gsap.timeline({ defaults: { ease: 'power2.out' } });
tl.from('.hero-badge', { opacity: 0, y: 16, duration: 0.4 })
.from('.hero-headline', { opacity: 0, y: 20, duration: 0.5 }, '-=0.2')
.from('.hero-subtext', { opacity: 0, y: 16, duration: 0.4 }, '-=0.3')
.from('.hero-cta', { opacity: 0, scale: 0.95, duration: 0.35 }, '-=0.2');
return tl;
}
// スクロールトリガー機能カード
gsap.utils.toArray<HTMLElement>('.feature-card').forEach((card, i) => {
gsap.from(card, {
opacity: 0,
y: 32,
duration: 0.5,
delay: i * 0.08,
ease: 'power2.out',
scrollTrigger: {
trigger: card,
start: 'top 85%',
once: true,
},
});
});
GSAPタイムラインでの
'-=0.2'オフセットは、スムーズで凝集性のあるシーケンスのためにステップ間のオーバーラップを作成します。これがないと、各ステップが切り離されて感じられます。前のステップの持続時間の20〜40%をオーバーラップさせてください。
prefers-reduced-motionを尊重する
/* CSS - セーフティネットとしての包括ルール */
@media (prefers-reduced-motion: reduce) {
*,
*::before,
*::after {
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.01ms !important;
scroll-behavior: auto !important;
}
}
// Framer Motion - useReducedMotionフック
import { useReducedMotion } from 'framer-motion';
function AnimatedCard({ children }: { children: React.ReactNode }) {
const prefersReduced = useReducedMotion();
return (
<motion.div
initial={prefersReduced ? false : { opacity: 0, y: 12 }}
animate={{ opacity: 1, y: 0 }}
transition={prefersReduced ? { duration: 0 } : { duration: 0.2 }}
>
{children}
</motion.div>
);
}
// バニラJS - GSAPを実行する前に設定を確認
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (!prefersReduced) {
animateHero();
}
アンチパターン
| ミス | なぜ間違っているのか | 代わりに何をするべきか |
|---|---|---|
width、height、top、leftをアニメーション化する | 毎フレームレイアウトの再計算を引き起こし、ジャンクの原因になる | 代わりにtransform: scale()またはtransform: translate()を使用する |
transition: all | 予期しないプロパティをキャッチし、予測が難しく、パフォーマンスリスクがある | 特定のプロパティを列挙する:transition: transform 200ms, opacity 200ms |
| インタラクティブフィードバックで500ミリ秒を超える持続時間 | ユーザーはUIが遅れているか壊れていると感じる | ボタン/ホバー/トグルは200ミリ秒未満、モーダルは300ミリ秒未満に保つ |
| 単純なホバー効果にGSAPを使用する | CSSがネイティブに処理できるものに大きなオーバーヘッドがかかる | 状態変更にはCSS transitionを、タイムラインにはGSAPのみを使用する |
| スターガーディレイの合計が500ミリ秒を超える | ユーザーはコンテンツが表示されるのを待つ代わりに待たされる | アイテムごとのディレイは75ミリ秒、スターガーの合計は400ミリ秒に制限する |
すべての要素にwill-change: transform | 各will-changeはGPUレイヤーを作成する – 過剰に使用するとVRAMを浪費する | アニメーション化することがわかっている要素にのみ追加し、アニメーション後は削除する |
参考文献
特定のモーショントピックに関する詳細なガイダンスについては、references/フォルダから関連ファイルをお読みください: