React / 系统课时

认识单页应用路由

认识单页应用路由

单页应用路由解决的是“地址变了,但不要整页重新加载”的页面切换问题。本节会用浏览器 History API 和一个最小 React 示例拆开这条链路,让你看清 URL、路由状态与组件渲染之间的关系。

学习目标

  • 说明单页应用路由与传统整页跳转的核心差异
  • 理解 pushState、popstate 与 React 渲染之间的配合
  • 判断哪些地址变化属于客户端路由,哪些仍会触发服务器请求

路由到底切换了什么

传统多页网站点击链接后,浏览器通常会向服务器请求新的 HTML 文档;单页应用则尽量保留当前文档,只改变地址与应用状态,再由 React 重新渲染对应页面组件。

因此,“路由切页”并不是把一个 HTML 文件替换成另一个 HTML 文件,而是完成三件事:更新 URL、根据 URL 得到当前页面状态、让组件树渲染新的页面内容。

单页应用客户端路由链路

地址变化时浏览器发生什么

客户端主动切换页面时,可以调用 history.pushState() 写入新的历史记录。这个调用会改变地址栏,但不会自动向服务器请求新文档,也不会自动触发 popstate。

当用户点击浏览器后退或前进时,历史记录位置发生变化,浏览器才会触发 popstate。React 应用通常监听这个事件,把新的 location.pathname 写入状态,再按路径选择组件。

这里有一个关键边界:如果用户直接在地址栏输入 /about 并回车,或在该地址刷新页面,浏览器仍会向服务器请求 /about。生产环境需要把这类未知前端路径回退到应用入口 HTML。

用最小示例验证不刷新切页

下面代码可直接替换 Vite React 项目的 src/main.jsx。它没有使用第三方路由库,只用 History API 演示客户端路由最核心的工作方式。

jsx
import React, { useEffect, useState } from "react";
import { createRoot } from "react-dom/client";

function App() {
  const [path, setPath] = useState(window.location.pathname);

  useEffect(() => {
    const handlePopState = () => setPath(window.location.pathname);
    window.addEventListener("popstate", handlePopState);
    return () => window.removeEventListener("popstate", handlePopState);
  }, []);

  function navigate(event, nextPath) {
    event.preventDefault();
    // pushState 只修改历史记录与 URL,不会重新加载当前文档。
    window.history.pushState({}, "", nextPath);
    setPath(nextPath);
  }

  return (
    <main>
      <nav>
        <a href="/" onClick={(event) => navigate(event, "/")}>首页</a>
        {" | "}
        <a href="/about" onClick={(event) => navigate(event, "/about")}>关于</a>
      </nav>
      <h1>{path === "/about" ? "关于页面" : "首页"}</h1>
    </main>
  );
}

createRoot(document.getElementById("root")).render(<App />);

预期结果

text
初始访问 / 时显示“首页”。
点击“关于”后,地址栏变为 /about,页面显示“关于页面”,当前文档不重新加载。
再点击浏览器后退按钮,地址恢复为 /,页面重新显示“首页”。

容易混淆的边界

客户端路由并不会让服务器“认识”所有前端路径。应用内点击通常由 JavaScript 接管,而刷新、书签直达或外部链接访问仍从服务器开始,因此部署时需要配置 history fallback。

路由也不等于状态管理。路由状态描述“当前地址对应哪个页面”,表单内容、购物车或登录用户等业务状态仍应由组件状态、Context 或专门的状态管理方案负责。真正的路由库会在这个基础上继续处理路径匹配、嵌套、参数、重定向与数据加载等能力。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

认识单页应用路由

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通