re:re:actable
Урок 074 минуты чтения

Модальное окно с собственным URL: parallel и intercepting routes

На этой странице
Кратко

Классический паттерн Instagram-подобных интерфейсов: клик по карточке в ленте открывает модалку поверх списка, но URL меняется на /photos/42. Ссылкой можно поделиться, «Назад» закрывает модалку, а прямой заход или перезагрузка открывают полноценную страницу /photos/42. В App Router это собирают из двух механизмов: parallel route — слот @modal в layout, который рендерится рядом с children, и intercepting route — папка (.)photos/[id] внутри слота, которая перехватывает клиентскую навигацию на /photos/[id] и показывает модалку вместо полной страницы. Обязательны default.tsx для слота (иначе 404 при перезагрузке; в Next 16 — без исключений) и закрытие через router.back().

Вопрос

Как в Next.js сделать модальное окно, у которого есть свой URL, работает кнопка «Назад», а при перезагрузке открывается полноценная страница?

Структура

app/
├── layout.tsx                 ← рендерит {children} и {modal}
├── page.tsx                   ← лента фотографий
├── @modal/
│   ├── default.tsx            ← null: модалки нет
│   └── (.)photos/[id]/
│       └── page.tsx           ← модалка при клиентском переходе
└── photos/[id]/
    └── page.tsx               ← полная страница (прямой заход, перезагрузка)

Соглашения перехвата: (.) — тот же уровень, (..) — на уровень выше, (..)(..) — на два, (...) — от корня app. Уровень считается по сегментам маршрута, а не по папкам (слот @modal и группы не считаются).

Layout со слотом

// app/layout.tsx
export default function RootLayout({ children, modal }: { children: React.ReactNode; modal: React.ReactNode }) {
  return (
    <html lang="ru">
      <body>
        {children}
        {modal}
      </body>
    </html>
  );
}
// app/@modal/default.tsx — что показывать в слоте, когда модалки нет
export default function Default() {
  return null;
}

Лента со ссылками

// app/page.tsx
import Link from 'next/link';
 
export default async function Feed() {
  const photos = await getPhotos();
  return (
    <ul className="grid">
      {photos.map((p) => (
        <li key={p.id}>
          <Link href={`/photos/${p.id}`} scroll={false}>
            <img src={p.thumb} alt={p.alt} width={300} height={300} />
          </Link>
        </li>
      ))}
    </ul>
  );
}

scroll={false} не прокручивает ленту наверх при открытии модалки.

Перехватывающий маршрут (модалка)

// app/@modal/(.)photos/[id]/page.tsx
import { Modal } from '@/components/modal';
import { PhotoView } from '@/components/photo-view';
 
export default async function PhotoModal({ params }: PageProps<'/photos/[id]'>) {
  const { id } = await params;
  const photo = await getPhoto(id);
  return (
    <Modal title={photo.title}>
      <PhotoView photo={photo} />
    </Modal>
  );
}
// components/modal.tsx
'use client';
 
import { useRouter } from 'next/navigation';
import { useEffect, useRef } from 'react';
 
export function Modal({ title, children }: { title: string; children: React.ReactNode }) {
  const router = useRouter();
  const ref = useRef<HTMLDialogElement>(null);
 
  useEffect(() => {
    if (!ref.current?.open) ref.current?.showModal(); // фокус внутрь, Esc, inert фона
  }, []);
 
  return (
    <dialog
      ref={ref}
      aria-labelledby="photo-modal-title"
      onClose={() => router.back()} // Esc и закрытие → вернуться к ленте
      onClick={(e) => e.target === ref.current && router.back()} // клик по фону
    >
      <h2 id="photo-modal-title">{title}</h2>
      {children}
      <button onClick={() => router.back()}>Закрыть</button>
    </dialog>
  );
}

router.back() возвращает предыдущий URL — слот снова получает default.tsx, модалка исчезает, а лента не перерисовывалась и сохранила скролл.

Полная страница

// app/photos/[id]/page.tsx — прямой заход, перезагрузка, поисковые роботы
export default async function PhotoPage({ params }: PageProps<'/photos/[id]'>) {
  const { id } = await params;
  const photo = await getPhoto(id);
  if (!photo) notFound();
  return (
    <main>
      <h1>{photo.title}</h1>
      <PhotoView photo={photo} />
    </main>
  );
}

Общий компонент PhotoView используется и в модалке, и на странице.

Как ведёт себя навигация

ДействиеЧто показывается
Клик по фото в лентеЛента + модалка (перехват), URL /photos/42
«Назад»Лента, модалка закрыта
Перезагрузка на /photos/42Полная страница (перехват работает только при клиентской навигации)
Ссылка из мессенджераПолная страница
Клик по ссылке на другую страницу из модалкиСлот получит default.tsx, модалка закроется

Другие применения слотов

  • Логин в модалке поверх любой страницы (@auth/(.)login), но /login открывается и отдельно.
  • Корзина — боковая панель с URL /cart.
  • Дашборды: несколько независимых слотов (@analytics, @team) со своими loading.tsx и error.tsx — каждый грузится и падает отдельно.
  • Условные слоты: показать @admin или @user в зависимости от роли.

Частые ошибки

  • Нет default.tsx у слота → 404 или ошибка при прямом заходе на другие маршруты.
  • Неправильный уровень перехвата ((..) вместо (.)) — перехват не срабатывает.
  • Закрытие модалки через router.push('/') — ломает историю и теряет состояние ленты.
  • Модалка без управления фокусом и Esc — используй <dialog> или headless-библиотеку.

Мини-шпаргалка

@modal — слот, prop modal в layout
@modal/default.tsx → null
@modal/(.)photos/[id]/page.tsx — перехват клиентской навигации
photos/[id]/page.tsx — полная страница
(.) (..) (..)(..) (...) — уровни по сегментам
router.back() закрывает; <Link scroll={false}>

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам