Motion (Framer Motion) — Skill
Nome: motion
Propósito: Implementar animações suaves e acessíveis com motion/react em React.
Use este skill sempre que adicionar animações, gestos ou transições de layout.
Aplicável quando: Usando motion/react (motion, AnimatePresence, useScroll, etc.).
Não use quando: Nenhuma animação for necessária ou o componente for estritamente renderizado no servidor.
Regras
- Limite client-only: Motion requer
'use client'; mantenha as ilhas client pequenas. - Comece simples: Comece com opacidade/translate antes de adicionar física spring.
- Use a ferramenta certa:
AnimatePresencepara entrada/saída,layoutpara layout,whileHover/whileTappara gestos. - Respeite movimento reduzido: Use
useReducedMotion(). - Disciplina de bundle: Use
LazyMotionpara superfícies de animação maiores.
Fluxo de trabalho
- Identifique o propósito de UX (feedback, transição, foco).
- Adicione o menor limite
'use client'. - Implemente transições de entrada/saída ou layout corretamente.
- Respeite as preferências de movimento reduzido.
- Verifique desempenho e tamanho do bundle.
Listas de verificação
Lista de verificação de implementação
-
'use client'apenas onde necessário - Comportamento de movimento reduzido definido
-
AnimatePresenceenvolve UI condicional - Transições de layout usam
layout
Lista de verificação de revisão
- Animações não são executadas novamente a cada renderização
- Código de animação não expande desnecessariamente a árvore client
Exemplos mínimos
Entrada/saída
"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>
);
}
Animação de layout
"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>
);
}
Movimento reduzido
"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>
);
}
Erros comuns / armadilhas
- Desmontar sem
AnimatePresence(animações de saída nunca são executadas) - Animar layout sem
layout - Colocar Motion em uma árvore client enorme
- Animar listas grandes sem virtualização