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

Cum faci un modal curat în Next.js cu Parallel și Intercepting Routes

De Mihai Popescu, 18 oct. 2026 · 27 vizualizări · 2 like-uri

Postat 18 oct. 2026
typescript
// app/@modal/(.)photos/[id]/page.tsx
'use client';

import { useRouter } from 'next/navigation';

export default function PhotoModal({ params }: { params: { id: string } }) {
  const router = useRouter();

  return (
    <div className="fixed inset-0 bg-black/70 z-50 flex items-center justify-center p-4">
      {/* Backdrop click pentru închidere */}
      <div className="absolute inset-0" onClick={() => router.back()} />
      
      <div className="relative bg-neutral-900 border border-neutral-800 p-6 rounded-xl max-w-lg w-full z-10">
        <h2 className="text-xl font-bold text-white">Photo ID: {params.id}</h2>
        <p className="text-neutral-400 mt-2">Randat prin Intercepting Route.</p>
        <button 
          onClick={() => router.back()}
          className="mt-4 px-4 py-2 bg-white text-black rounded font-medium text-sm"
        >
          Închide
        </button>
      </div>
    </div>
  );
}

Am implementat pattern-ul ăsta anul trecut pentru o platformă de licitații auto cu vreo 15k listări active. Clientul voia exact comportamentul de Instagram sau Pinterest: ești în feed, apeși pe o mașină, se deschide modalul instant peste listă cu URL-ul schimbat la /photos/123, dar dacă trimiți link-ul pe WhatsApp sau dai F5, se încarcă pagina dedicată, full-screen. Fără Redux, fără Zustand și fără isOpen plimbat prin 7 straturi de componente.

În Pages Router era o durere cruntă să faci asta curat cu shallow routing. În App Router avem la dispoziție două unelte native: Parallel Routes (sloturile cu @) și Intercepting Routes (folderele cu convenție tip regex (.)). Combinate cum trebuie, fac exact ce promit. Dacă greșești o singură convenție de numire, te alegi cu erori ciudate de 404 la soft navigation.

Structura de foldere care nu-ți dă bătăi de cap

Secretul stă în plasarea slotului paralel la nivelul unde vrei să apară overlay-ul. Dacă feed-ul tău e în root (/app), structura arată cam așa:

  • app/layout.tsx (aici primești props-urile children și modal)
  • app/@modal/(.)photos/[id]/page.tsx (pagina interceptată)
  • app/@modal/default.tsx (esențial! întoarce null)
  • app/photos/[id]/page.tsx (pagina reală, accesată la refresh direct)

Convenția (.) îi zice lui Next.js: „Când navigarea vine de pe același nivel relativ, nu schimba pagina completă, ci randează ruta asta în slotul @modal definit în layout”. Când userul intră din exterior (hard navigation / direct link), Next.js ignoră complet folderul (.)photos și randează direct /photos/[id]/page.tsx ca pagină de sine stătătoare.

Capcana clasică: fișierul default.tsx

Mi-au mâncat nervii vreo 3 ore prima dată când am implementat asta, pentru că uitasem de default.tsx.

Next.js are nevoie de un fallback pentru slotul @modal atunci când utilizatorul navighează pe o pagină care NU este interceptată. Dacă userul intră pe /about sau chiar pe /, slotul paralel @modal nu are ce să afișeze. Dacă nu pui un default.tsx care returnează null în interiorul folderului @modal, Next.js va arunca 404 la primul refresh pe paginile adiacente sau va păstra modalul vechi pe ecran din cache.

Trade-off-uri reale

Merge brici pentru galerii foto, preview de documente sau formulare de quick-edit. Experiența pentru user e impecabilă, tranziția se simte nativă (0ms server roundtrip dacă datele vin din cache).

Unde devine nasol? La managementul istoricului din browser. Dacă utilizatorul deschide modalul, apasă pe un tab intern din modal (să zicem /photos/123?tab=details), iar apoi apasă pe backdrop să închidă modalul, un simplu router.back() nu-l va trimite înapoi în feed, ci la tab-ul anterior. Dacă vrei comportament bulletproof la dismiss, trebuie să verifici istoricul sau să folosești explicit un router.push('/') pe backdrop click, ceea ce uneori resetează scroll-ul din feed dacă nu ești atent la scroll restoration.

Voi ce folosiți când aveți nevoie de URL dedicat pe modaluri: rămâneți pe URL query params clasice (?modal=123) sau ați adoptat intercepting routes în producție?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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