eduardweb.
Animații (Framer Motion)Intermediar#nextjs#react#framer-motion#frontend

Tranziții între pagini cu AnimatePresence în App Router: ce merge și ce e țeapă

De Mihai Popescu, 11 nov. 2026 · 12 vizualizări · 3 like-uri

Postat 11 nov. 2026
typescript
'use client';

import { useContext, useRef } from 'react';
import { LayoutRouterContext } from 'next/dist/shared/lib/app-router-context.shared-runtime';

export function FrozenRoute({ children }: { children: React.ReactNode }) {
  const context = useContext(LayoutRouterContext ?? {});
  const frozen = useRef(context).current;

  return (
    <LayoutRouterContext.Provider value={frozen}>
      {children}
    </LayoutRouterContext.Provider>
  );
}

Dacă ai migrat de la Pages Router la App Router crezând că AnimatePresence o să meargă la fel de simplu ca în _app.tsx, probabil ai realizat rapid că Next.js îți ignoră complet animația de exit. Am pățit-o la sfârșitul anului trecut pe un proiect de SaaS cu vreo 8k useri activi: animațiile de intrare funcționau brici, dar la click pe altă pagină, nodul vechi dispărea instantaneu din DOM fără niciun fade sau slide.

Motivul e simplu: în App Router, navigarea demufează componentele la nivel de server/tree înainte ca Framer Motion să poată suspenda unmount-ul. Layout-urile persistă, iar paginile sunt Server Components by default.

De ce template.tsx rezolvă doar jumătate de problemă

Prima reacție a multora e să folosească template.tsx în loc de layout.tsx. Documentația Next.js zice clar că template instanțiază o componentă nouă la fiecare navigare.

Sună perfect, nu? Ei bine, funcționează doar pentru enter animations.

Dacă bagi un simplu <motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }}> într-un template.tsx, o să vezi cum pagina nouă intră elegant. Problema apare când vrei mode="wait" pe AnimatePresence ca pagina veche să facă fade-out înainte ca pagina nouă să se randeze. Next.js schimbă arborele React prea repede, iar Framer Motion nu primește semnalul de reținere în memorie.

Soluția stabilă: Freeze context-ul rutei

Ca să convingi App Router-ul să păstreze nodul vechi pe ecran până își termină exit-ul, trebuie să-i îngheți contextul de navigare.

Ideea de bază e să folosești un FrozenRoute wrapper. Luăm usePathname() dintr-un Client Component wrapper așezat în rădăcina layout-ului și păstrăm copiii anteriori în starea locală până când callback-ul de onExitComplete semnalează că Framer Motion a terminat tranziția.

Codul de mai jos e extras direct dintr-un proiect de producție și folosește LayoutRouterContext-ul intern din Next.js pentru a preveni render-ul instantaneu al noii rute.

Trade-off-uri pe care trebuie să le știi

Nu există magie curată aici. Soluția asta vine cu niște compromisuri reale:

  1. Layout shift pe rute lungi: dacă pagina A are un scroll de 3000px și utilizatorul e jos, iar pagina B are doar 400px, containerul cu mode="wait" va ține înălțimea veche încă 250-300ms. E musai să gestionezi overflow: hidden pe containerul animat.
  2. Timp de navigare perceput: adaugi artificial latență la UX. O animație de exit de 200ms înseamnă că userul așteaptă 200ms în plus înainte să vadă primul pixel util din ruta nouă, indiferent cât de repede răspunde serverul.
  3. Dependența de internele Next.js: folosirea LayoutRouterContext funcționează de la Next 13.4 până la 15, dar rămâne un API privat care s-ar putea schimba pe viitor.

Pentru majoritatea aplicațiilor de tip dashboard, eu prefer tranzițiile de enter scurte (150ms) direct în template.tsx fără exit. Câștigi viteză brută și scapi de complexitate. Lăsați mode="wait" doar pentru flows de onboarding sau prezentări unde contează cinematica.

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

Doar membrii comunității pot lăsa comentarii.