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

Cum faci modale ca pe Instagram în Next.js cu Intercepting și Parallel Routes

De George Iliescu, 30 oct. 2026 · 19 vizualizări · 3 like-uri

Postat 30 oct. 2026
typescript
'use client';

import { useRouter } from 'next/navigation';
import { useCallback, useEffect } from 'react';

export function Modal({ children }: { children: React.ReactNode }) {
  const router = useRouter();

  const onDismiss = useCallback(() => {
    router.back();
  }, [router]);

  useEffect(() => {
    const onKeyDown = (e: KeyboardEvent) => {
      if (e.key === 'Escape') onDismiss();
    };
    document.addEventListener('keydown', onKeyDown);
    return () => document.removeEventListener('keydown', onKeyDown);
  }, [onDismiss]);

  return (
    <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/70">
      <div className="relative max-w-3xl rounded-xl bg-neutral-900 p-6">
        <button
          onClick={onDismiss}
          className="absolute right-4 top-4 text-neutral-400 hover:text-white"
        >
          ✕
        </button>
        {children}
      </div>
    </div>
  );
}

Pattern-ul clasic de photo modal – stil Instagram, X sau Pinterest – arată simplu la suprafață, dar în Next.js Pages router cerea un talmeș-balmeș de shallow routing, query params și state ținut manual în memorie. În App Router avem în sfârșit un API nativ pentru asta prin combinația de Parallel Routes (@slot) și Intercepting Routes ((.)route).

Am refăcut flow-ul ăsta la începutul anului pentru o platformă foto cu vreo 25k de imagini indexate. Voiam două lucruri clare: dacă omul dă click pe un card, feed-ul din spate rămâne intact și apare modalul peste el, cu URL-ul schimbat la /photos/[id]. Dacă îi dă copy-paste la link pe Slack sau dă F5, primește direct pagina full de detaliu, cu SSR curat și metadata completă.

Cum arată structura de foldere (fără să-ți prinzi urechile)

Trucul e că Next.js trebuie să știe ce să randeze când ești pe ruta principală și ce să pună în slot când interceptează o navigare pe client. În app/ ai nevoie de:

app/
├── @modal/
│   ├── (.)photos/
│   │   └── [id]/
│   │       └── page.tsx
│   └── default.tsx
├── photos/
│   └── [id]/
│       └── page.tsx
├── layout.tsx
└── page.tsx

În layout.tsx, primești slotul ca prop: export default function RootLayout({ children, modal }: { children: React.ReactNode, modal: React.ReactNode }). Când ești pe homepage (/), children randează feed-ul. Ce randează modal? Aici intră în scenă fișierul default.tsx din rădăcina @modal.

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

Am pierdut două ore bune prima dată când am implementat asta pentru că Next.js arunca un 404 ciudat la navigare. Dacă nu definești un default.tsx în interiorul slotului @modal care să returneze pur și simplu null, routerul nu știe ce să pună acolo în timpul unui hard refresh sau pe rutele unde slotul nu e activat. La fel, dacă ai sub-rute, slotul are nevoie de fallback explicit.

Intercepția funcționează cu notații relative:

  • (.) interceptează rute la același nivel.
  • (..) interceptează un nivel mai sus.
  • (...) interceptează de la rădăcina app.

În cazul nostru, @modal/(.)photos/[id] stă lângă folderul photos/, deci prefixul (.) îi spune motorului de rutare: „când userul dă click pe un <Link href="/photos/123">, nu descărca toată pagina photos/[id], ci trimite componenta asta în slotul @modal”.

Închiderea modalului și curățarea URL-ului

Ca să închizi modalul, cea mai elegantă metodă rămâne useRouter().back(). Asta face popstate în istoricul browserului, URL-ul revine la /, iar slotul @modal revine automat la starea din default.tsx (adică null).

Merge perfect pentru UX de gallery, dar vine cu un compromis major pe care trebuie să-l asumi din start: animațiile de exit. Când apelezi router.back(), Next demontează instant componenta din slot. Dacă folosești Framer Motion sau Radix UI Dialog, animația de fade-out e retezată brusc dacă nu o întârzii manual cu un state local de isClosing înainte să tragi de router.

Voi cum gestionați animațiile de exit pe intercepting routes? Ați găsit un workaround curat sau preferați să lăsați închiderea instantanee?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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