Motion(Framer Motion) — スキル
名前: motion
目的: Reactでmotion/reactを使用して、スムーズでアクセシブルなアニメーションを実装します。
アニメーション、ジェスチャー、またはレイアウトトランジションを追加するたびにこのスキルを使用してください。
適用する場合: motion/react(motion、AnimatePresence、useScrollなど)を使用している場合。
使用しない場合: アニメーションが不要な場合、またはコンポーネントが厳密にサーバーレンダリングされる場合。
ルール
- クライアントのみのバウンダリ: Motionは
'use client'を必要とします。クライアントアイランドは小さく保ってください。 - シンプルに始める: スプリング物理演算を追加する前に、不透明度/移動から始めてください。
- 適切なツールを使用: Enter/Exitには
AnimatePresence、レイアウトにはlayout、ジェスチャーにはwhileHover/whileTapを使用してください。 - 動きの抑制に対応:
useReducedMotion()を使用してください。 - バンドルサイズ規律: 大規模なモーションサーフェスには
LazyMotionを使用してください。
ワークフロー
- UXの目的(フィードバック、トランジション、フォーカス)を特定する。
- 最小の
'use client'バウンダリを追加する。 - Enter/Exitまたはレイアウトトランジションを正しく実装する。
- 動きの抑制設定に対応する。
- パフォーマンスとバンドルサイズを確認する。
チェックリスト
実装チェックリスト
-
'use client'は必要な場所にのみ配置されている - 動きの抑制時の動作が定義されている
-
AnimatePresenceが条件付きUIをラップしている - レイアウトトランジションには
layoutを使用している
レビューチェックリスト
- アニメーションがレンダリングのたびに再実行されない
- モーションコードが不必要にクライアントツリーを拡大していない
最小限の例
Enter/Exit
"use client";
import { AnimatePresence, motion } from "motion/react";
export function Toast({
open,
children,
}: {
open: boolean;
children: React.ReactNode;
}) {
return (
<AnimatePresence>
{open ? (
<motion.div
initial={{ opacity: 0, y: 8 }}
animate={{ opacity: 1, y: 0 }}
exit={{ opacity: 0, y: 8 }}
transition={{ duration: 0.18 }}
>
{children}
</motion.div>
) : null}
</AnimatePresence>
);
}
レイアウトアニメーション
"use client";
import { motion } from "motion/react";
export function Expander({ open }: { open: boolean }) {
return (
<motion.div layout className="overflow-hidden rounded-md border p-3">
<div className="font-medium">Title</div>
{open ? <div className="mt-2 text-sm">More content...</div> : null}
</motion.div>
);
}
動きの抑制
"use client";
import { motion, useReducedMotion } from "motion/react";
export function FadeIn({ children }: { children: React.ReactNode }) {
const reduce = useReducedMotion();
return (
<motion.div
initial={reduce ? false : { opacity: 0, y: 6 }}
animate={reduce ? { opacity: 1 } : { opacity: 1, y: 0 }}
transition={{ duration: 0.2 }}
>
{children}
</motion.div>
);
}
よくある間違い/落とし穴
AnimatePresenceなしでアンマウントする(Exitアニメーションが決して実行されない)layoutなしでレイアウトをアニメーションする- Motionを巨大なクライアントツリー内に配置する
- 仮想化せずに大規模なリストをアニメーションする