eduardweb.
App RouterAvansat#nextjs#react#frontend#app-router

Modal cu URL dedicat în Next.js App Router: cum eviți capcanele la refresh

De Diana Oprea, 16 nov. 2026 · 15 vizualizări · 2 like-uri

Postat acum 5 zile
typescript
// app/layout.tsx
export default function RootLayout({
  children,
  modal,
}: {
  children: React.ReactNode;
  modal: React.ReactNode;
}) {
  return (
    <html lang="ro">
      <body>
        {children}
        {modal}
      </body>
    </html>
  );
}

// app/@modal/default.tsx
export default function Default() {
  return null;
}

Vrei să dai click pe un card din feed, URL-ul să se schimbe în /photos/123, să apară un modal peste pagină, iar dacă trimiți linkul unui prieten, el să vadă doar poza pe tot ecranul. Next.js promite treaba asta nativ prin parallel routes și intercepting routes. Sună impecabil în documentație, dar la implementare dai rapid cu capul de pragul de sus dacă nu ești atent la structură.

Am implementat pattern-ul ăsta anul trecut pe un catalog cu vreo 12.000 de imagini. Până am prins toate chichițele cu sloturile care rămâneau agățate în memorie, am înjurat câteva ore bune.

Structura de foldere care contează

Secretul stă în convenția de denumire. Ca să interceptezi ruta din același nivel sau dintr-un segment părinte, folosești sintaxa cu paranteze rotunde: (.) pentru același nivel, (..) pentru un nivel mai sus.

Ai nevoie de trei piese esențiale în folderul tău:

  1. Slotul paralel @modal în root-ul secțiunii (de exemplu în app/).
  2. Interceptarea propriu-zisă: app/@modal/(.)photos/[id]/page.tsx.
  3. Pagina standard completă: app/photos/[id]/page.tsx.

Când navighezi pe client (prin <Link> sau router.push), Next.js vede interceptarea și randează componenta din @modal peste conținutul curent. Când dai F5 pe /photos/123, Next.js ignoră complet interceptorul și încarcă direct app/photos/[id]/page.tsx ca pagină de sine stătătoare.

Fișierul default.tsx: motivul pentru care primești 404

Cea mai frecventă greșeală e lipsa fișierului default.tsx. Dacă ești pe homepage (/) și nu ai o rută interceptată activă, slotul @modal nu știe ce să randeze. Dacă nu-i pui un fallback, Next.js aruncă un 404 neașteptat la navigare.

Soluția e banală: în app/@modal/default.tsx returnezi pur și simplu null. Fără asta, tot mecanismul se dărâmă în momentul în care userul navighează înapoi pe o pagină care nu are treabă cu modalul.

Închiderea modalului și istoricul din browser

Cum închizi dialogul? Varianta naivă e un state local în React. Dacă faci asta, URL-ul din browser rămâne blocat pe /photos/123. Ca să fie treaba curată, închiderea trebuie să fie o navigare în istoric: router.back().

Aici apare un mic trade-off: dacă userul a ajuns pe modal venind dintr-un alt site (printr-un link direct), router.back() o să-l trimită afară din aplicația ta în loc să închidă modalul și să-i arate feed-ul. Pentru cazul ăsta, dacă modalul a fost deschis pe o sesiune fără istoric intern, verifici window.history.length sau pui un fallback explicit către / cu un router.push('/').

Merită efortul?

Pattern-ul e excelent pentru feed-uri de produse, galerii foto sau panouri de detalii unde UX-ul de desktop cere context vizual în spate, dar vrei link-uri direct share-uibile pentru SEO și social media. E nasol însă dacă ai layout-uri adânc imbricate: sloturile paralele se propagă doar în layout-ul direct părinte, așa că dacă ai nevoie de același modal deschis din 3 locuri complet diferite din arborele de rute, structura devine un mic coșmar de duplicat directoare.

Voi ați lovit probleme de cache pe rutele interceptate la trecerea între versiuni de Next?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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