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

Modal cu URL propriu în Next.js App Router: parallel și intercepting routes

De Paul Ene, 11 nov. 2026 · 17 vizualizări · 2 like-uri

Postat 11 nov. 2026
typescript
// app/@modal/(.)photos/[id]/page.tsx
import { Modal } from '@/components/ui/modal';
import PhotoDetail from '@/components/photo-detail';

interface Props {
  params: Promise<{ id: string }>;
}

export default async function PhotoModal({ params }: Props) {
  const { id } = await params;
  
  return (
    <Modal>
      <PhotoDetail photoId={id} isModal />
    </Modal>
  );
}

Pattern-ul de modal peste feed (Instagram sau Pinterest style) a fost mereu o durere de cap în Next.js Pages router. Ne chinuiam cu shallow routing, query params gen ?modal=true și useEffect-uri oribile care desincronizau istoricul din browser. În App Router avem în sfârșit o soluție nativă via parallel routes (@slot) și intercepting routes ((..)dir), dar setup-ul inițial e plin de capcane.

Structura de foldere care dă bătăi de cap

Secretul stă în convenția de denumire a folderelor. La un proiect de portofoliu cu vreo 12.000 de imagini indexate, aveam nevoie ca un click din galerie să deschidă modalul instant, dar dacă cineva trimite link-ul pe Slack (/photos/42), utilizatorul să primească pagina completă, nu o pagină albă.

Pentru asta, organizezi structura așa:

app/
├── @modal/
│   ├── (.)photos/
│   │   └── [id]/
│   │       └── page.tsx   <-- Interceptează client-side
│   └── default.tsx        <-- Esențial: returnează null
├── photos/
│   └── [id]/
│       └── page.tsx       <-- Fallback la refresh (SSR pur)
├── layout.tsx             <-- Primește props.modal și props.children
└── page.tsx               <-- Galeria ta principală

Sintaxa (.)photos îi spune lui Next.js: „Când userul navighează prin <Link href="/photos/123"> de pe același nivel, nu încărca pagina întreagă; capturează ruta și arunc-o în slot-ul @modal din layout”.

Capcana numărul unu: fișierul default.tsx

90% din developeri se blochează aici. Dacă uiți să pui default.tsx în rădăcina slot-ului @modal, Next.js va crăpa la refresh sau când navighezi pe altă pagină care nu are interceptor activ.

Next.js are nevoie de o stare „goală” pentru slot-ul paralel atunci când ruta activă nu se potrivește cu nicio regulă de interceptare. Un simplu export default function Default() { return null; } rezolvă problema.

Închiderea modalului și istoricul de navigare

Când ești în modal, URL-ul din browser este deja /photos/123. Asta înseamnă că pentru a închide fereastra ai două variante:

  1. router.back(): varianta curată dacă utilizatorul a venit din galerie. Revine la URL-ul anterior și demontează slot-ul automat.
  2. <Link href="/">: varianta sigură dacă vrei să eviți surprizele în care utilizatorul a intrat printr-un link extern sau a dat refresh, caz în care router.back() l-ar putea trimite pe Google sau pe alt site din istoricul lui.

La proiectul menționat, am măsurat o scădere de 22% a bounce rate-ului pe variantele de mobil, pur și simplu pentru că gestul de „swipe back” nativ din Safari și Chrome închidea modalul firesc în loc să scoată omul de pe site.

Trade-off-uri reale

Merge brici pentru galerii, pagini de login contextual sau preview rapid de produs. Nu e deloc o soluție grozavă dacă ai flow-uri multi-step complexe în interiorul modalului (de exemplu un checkout în 3 pași cu sub-rute). Acolo complexitatea folderelor din @modal explodează și devine un coșmar de mentenanță.

Voi cum gestionați închiderea modalului când utilizatorul ajunge pe rută direct din afară, preferați router.back() sau redirecționare forțată pe pagina părinte?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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