
本文详解如何利用 组件构建固定左侧 Sidebar + 动态右侧内容的嵌套路由结构,确保所有子路由(如 /notes/123)均复用同一布局,无需重复渲染侧边栏。
本文详解如何利用 `
在 React Router v6 中,实现「常驻侧边栏 + 右侧动态内容 + 支持嵌套路由」的关键在于布局路由(Layout Route)模式——即通过父级路由组件统一定义 UI 结构,再使用 占位符渲染其匹配的子路由内容。
✅ 正确的布局组件写法
首先,将 App 组件重构为一个纯粹的布局容器(不再直接渲染业务内容),并引入 :
// App.tsx
import { Outlet } from 'react-router-dom';
import Sidebar from './Sidebar';
import Cards from './Cards';
const App = () => {
return (
<div style="{{" display: height:>
<sidebar></sidebar><cards></cards><main style="{{" flex: marginleft: sidebar css classname overflowy: padding:><outlet></outlet> {/* 子路由内容在此处动态插入 */}
</main>
</div>
);
};
export default App;
? 注意:
是 v6 新增的核心 API,仅在有children的路由中生效,它会自动渲染当前匹配的嵌套子路由元素。
✅ 对应的路由配置
确保父路由(/)的 element 指向该布局组件,并在 children 中定义具体页面路由:
将 React 应用升级到最新版本,从类组件迁移到 Hooks,并采用并发特性。用于现代化改造 React 代码库、迁移到 React Hooks 或升级到最新
// router.ts
import { createBrowserRouter } from 'react-router-dom';
import App from './App';
import Note from './Note';
const router = createBrowserRouter([
{
path: '/',
element: <app></app>, // 布局组件
children: [
{
index: true,
element: <div>Welcome to your dashboard!</div>,
},
{
path: 'notes/:id',
element: <note></note>,
},
// 可继续添加其他子路由,如 /settings、/profile 等,全部共享 Sidebar + Cards
],
},
]);
此时访问 /notes/42 时,React Router 会:
- 匹配到
/路由 → 渲染 - 在
内部,自动渲染 - Sidebar 和 Cards 始终保留在 DOM 中,不重新挂载,状态与 DOM 节点均被保留
⚠️ 常见误区与注意事项
- ❌ 不要将
Sidebar或Cards直接写在每个页面组件(如Note)内部 —— 这会导致每次跳转都销毁重建,失去状态且违背布局复用原则。 - ✅ 若需不同区域的布局(如登录页无侧边栏),可定义多个根级路由,例如:
{ path: '/auth', element: <authlayout></authlayout>, children: [/* 登录/注册路由 */] } - ✅ 推荐将
Sidebar和Cards提取为独立、轻量、受控的组件;若Cards需响应路由变化(如高亮当前笔记),可通过useParams或useLocation实现。 - ? 样式建议:用 CSS Flex/Grid 替代内联
marginLeft,提升可维护性;例如为Sidebar设置width: 250px; flex-shrink: 0,右侧容器设为flex: 1。
✅ 总结
React Router v6 的嵌套路由能力,本质上是“布局即组件”的思想落地。只要掌握 的定位作用,并将公共 UI(Sidebar、Header、Cards 等)上提至父级布局组件中,就能轻松实现专业级 SPA 的多区域持久化布局。无需第三方库,零额外开销,语义清晰,扩展性强。










