Вложенные маршруты (nested routes) и Outlet
На этой странице
Вложенные маршруты — маршруты, которые отображаются внутри родительского маршрута: родитель рендерит общую часть (шапку, меню, вкладки), а дочерний маршрут — изменяемую область. Место, куда React Router подставляет дочерний маршрут, обозначают компонентом <Outlet />. URL вложенного маршрута складывается из путей родителя и ребенка: /dashboard + settings = /dashboard/settings.
Вопрос
Что такое nested routes? Что делает Outlet и как устроены вложенные маршруты?
Основная идея
import { BrowserRouter, Routes, Route, Outlet, NavLink } from "react-router";
function App() {
return (
<BrowserRouter>
<Routes>
<Route path="/" element={<RootLayout />}>
<Route index element={<Home />} /> {/* "/" */}
<Route path="dashboard" element={<DashboardLayout />}>
<Route index element={<Overview />} /> {/* "/dashboard" */}
<Route path="settings" element={<Settings />} /> {/* "/dashboard/settings" */}
<Route path="users/:id" element={<User />} /> {/* "/dashboard/users/42" */}
</Route>
<Route path="*" element={<NotFound />} />
</Route>
</Routes>
</BrowserRouter>
);
}
function DashboardLayout() {
return (
<div className="dashboard">
<nav>
<NavLink to="." end>Обзор</NavLink>
<NavLink to="settings">Настройки</NavLink>
</nav>
<main>
<Outlet /> {/* сюда подставится Overview, Settings или User */}
</main>
</div>
);
}Как это работает
URL: /dashboard/settings
RootLayout
└─ <Outlet/> → DashboardLayout
└─ <Outlet/> → Settings- при переходе между дочерними маршрутами layout не размонтируется — сохраняет state и не перезагружает данные;
index-маршрут рендерится вOutlet, когда путь совпадает с родительским;- относительные ссылки (
to="settings") строятся от текущего маршрута.
Outlet: дополнительно
// передать данные дочерним маршрутам
<Outlet context={{ user }} />
// в дочернем маршруте
const { user } = useOutletContext();Если дочерний маршрут не совпал, <Outlet /> ничего не рендерит.
Layout-маршруты без пути
<Route element={<AuthGuard />}> {/* нет path — только обертка */}
<Route path="profile" element={<Profile />} />
<Route path="orders" element={<Orders />} />
</Route>
function AuthGuard() {
const user = useAuth();
return user ? <Outlet /> : <Navigate to="/login" replace />;
}Что важно помнить
- Вложенность маршрутов повторяет вложенность UI — это удобнее, чем дублировать layout на каждой странице.
- Каждому уровню можно назначить свой
errorElementи загрузчик данных (data routers). - В Next.js App Router тот же принцип реализован папками и файлами
layout.tsx, а рольOutletиграетchildren. NavLinkсendактивен только при точном совпадении пути.
Мини-шпаргалка
Nested routes: дочерний <Route> внутри родительского. Родитель рендерит общий layout и <Outlet /> — место для ребенка. index — маршрут по умолчанию. Layout не размонтируется при переходах. useOutletContext — данные вниз.
Документация
React Router: Routing — Nested Routes, React Router: Outlet, React Router: useOutletContext.