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

Cum faci modale shareabile cu Parallel și Intercepting Routes în Next.js

De Ioana Marinescu, 16 nov. 2026 · 13 vizualizări · 2 like-uri

Postat acum 5 zile
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 flex items-center justify-center z-50"
      onClick={() => router.back()}
    >
      <div 
        className="bg-neutral-900 p-6 rounded-xl max-w-lg w-full text-white"
        onClick={(e) => e.stopPropagation()}
      >
        <h2 className="text-xl font-bold mb-4">Photo ID: {params.id}</h2>
        <p className="text-neutral-400">Randat prin intercepting route.</p>
        <button 
          onClick={() => router.back()} 
          className="mt-4 px-4 py-2 bg-blue-600 rounded hover:bg-blue-500"
        >
          Închide
        </button>
      </div>
    </div>
  );
}

Pattern-ul clasic de Instagram e visul oricărui designer: ai o galerie, dai click pe poză, se deschide un modal instant fără să piardă scroll-ul, iar URL-ul devine /photos/123. Dacă trimiți link-ul pe Slack sau dai refresh, se deschide direct pagina dedicată, full-screen. În Pages Router rezolvam asta cu tot felul de mizerii în shallow routing și query params, dar în App Router avem combinația de Parallel Routes (@modal) și Intercepting Routes ((.)photos).

Sună intimidant din documentație, dar conceptul e simplu odată ce-l desenezi pe hârtie.

Cum funcționează convențiile de foldere

Ca să meargă treaba, ai nevoie de două lucruri în paralel: pagina standard și varianta interceptată. Structura arată cam așa:

  • app/photos/[id]/page.tsx — pagina normală, cea care se randează când cineva accesează linkul direct sau dă F5.
  • app/@modal/(.)photos/[id]/page.tsx — modalul care interceptează navigația doar atunci când vii din interiorul aplicației (soft navigation).
  • app/layout.tsx — primește slotul modal ca prop pe lângă children.

Simbolul (.) înseamnă că interceptezi ruta la același nivel. Dacă ruta ta era mai sus în ierarhie, foloseai (..). E fix ca sintaxa de cd . sau cd .. din terminal.

Detaliul unde se împiedică toată lumea: default.tsx

Când am implementat prima oară asta la un catalog de produse cu vreo 35k imagini, m-am lovit direct de ecran alb la primul reload. De ce? Fiindcă Next.js nu știe ce să pună în slotul @modal când faci o navigație hard (sau când dai back/forward la o pagină fără modal activ).

Trebuie să adaugi un fișier app/@modal/default.tsx care returnează pur și simplu null:

export default function Default() {
  return null;
}

Dacă omiți fișierul ăsta, Next.js aruncă 404 pe întreg layout-ul la refresh. Nu uita de el.

Cum închizi modalul curat

Pentru închidere, nu folosești state de React (isOpen = false), fiindcă URL-ul din browser trebuie să revină la starea anterioară. Soluția e să apelezi router.back() pe butonul de close sau pe click în afara ferestrei (pe backdrop).

Trade-off sincer: abordarea asta e genială pentru galeriile foto, feed-uri de social media sau vizualizatoare de documente. Userul păstrează scroll-ul din spate intact, iar la redeschidere totul e instantaneu din cache-ul de client. Pe de altă parte, dacă ai formulare complexe în acel modal și userul dă back din gestul de swipe pe telefon, pierzi datele din form fără avertisment dacă n-ai implementat un blocker de navigație separat. În plus, debugging-ul pe Safari iOS la tranziția de history poate deveni un coșmar dacă ai animații grele pe layout.

Voi cum ați rezolvat sincronizarea de date dacă userul dă edit/delete direct în modalul interceptat?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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