// 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:
router.back(): varianta curată dacă utilizatorul a venit din galerie. Revine la URL-ul anterior și demontează slot-ul automat.<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 carerouter.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?