React Router v7 路由切换加载状态实现指南

在单页应用开发中，路由切换时的加载状态是提升用户体验的重要环节。本文将详细介绍如何在React Router v7中优雅地实现路由切换时的加载效果。

核心概念：Suspense与懒加载

React Router v7深度集成了React的Suspense组件，这使得实现路由切换时的加载状态变得非常简单。Suspense允许我们在组件加载过程中显示一个fallback UI。

基础实现方案

1. 布局组件中的Suspense

在布局组件中包裹Outlet组件是最常见的做法：

import { Suspense } from "react";
import { Outlet, useLocation } from "react-router";

function Layout() {
  const location = useLocation();
  return (
    <div>
      <h1>应用标题</h1>
      <Suspense fallback={<div>加载中...</div>} key={location.key}>
        <Outlet />
      </Suspense>
    </div>
  );
}

关键点：

• key={location.key}确保每次路由变化都会触发新的Suspense
• fallback可以是任何React节点

2. 路由配置中的懒加载

结合React.lazy实现组件懒加载：

const About = lazy(() => import("./routes/about"));
const User = lazy(() => import("./routes/user"));

const router = createBrowserRouter([
  {
    path: "/",
    element: <Layout />,
    children: [
      { path: "about", element: <About /> },
      { path: "user", element: <User /> }
    ]
  }
]);

进阶技巧

1. 全局加载状态

对于整个应用的初始加载，可以使用HydrateFallback：

export function HydrateFallback() {
  return (
    <div className="loading-screen">
      <Spinner />
      <p>应用初始化中...</p>
    </div>
  );
}

2. 自定义加载组件

创建专业的加载指示器组件：

function LoadingIndicator() {
  return (
    <div className="fixed inset-0 flex items-center justify-center bg-black bg-opacity-50">
      <div className="animate-spin rounded-full h-12 w-12 border-t-2 border-b-2 border-white"></div>
    </div>
  );
}

性能优化建议

1. 预加载策略：在用户可能访问的路由上添加预加载逻辑
2. 代码分割：合理拆分路由组件，避免单个大包
3. 过渡动画：结合CSS过渡效果提升视觉体验

常见问题解决

1. 闪烁问题：确保Suspense的key属性正确设置
2. 加载状态不一致：统一所有路由的加载UI风格
3. 错误处理：配合ErrorBoundary处理加载失败情况

通过以上方法，开发者可以轻松实现React Router v7中的路由切换加载效果，显著提升用户体验。根据实际项目需求，可以灵活组合这些技术方案。