Модальное окно с собственным 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}>