如何构建一个不依赖框架的、渐进增强的客户端路由系统？-js教程-PHP中文网

如何构建一个不依赖框架的、渐进增强的客户端路由系统？

紅蓮之龍

发布： 2025-09-26 12:45:01

原创

899人浏览过

先保证链接可访问和页面跳转，再用 JavaScript 增强体验。通过原生 History API（pushState、replaceState）更新 URL 并监听 popstate 事件实现无刷新路由，拦截内链点击进行异步内容加载；结合路由表匹配路径并渲染对应视图，支持动态插入 HTML 或懒加载片段；服务端返回统一入口页以保障无 JS 时的基础可用性，实现渐进增强；附加标题管理、loading 提示与 hash fallback 兼容旧环境，核心是分层控制：HTML 负责可用，JS 提升体验。

如何构建一个不依赖框架的、渐进增强的客户端路由系统？

构建一个不依赖框架的客户端路由系统，核心在于利用浏览器原生能力实现 URL 变化监听和页面内容动态更新，同时确保基础功能在无 JavaScript 环境下仍可用——这就是“渐进增强”的本质。重点是先保证链接可访问、页面可跳转，再用 JavaScript 增强体验，避免全量依赖前端逻辑。

使用原生 History API 和事件监听

现代浏览器提供了 History API（如 pushState 和 replaceState）来修改 URL 而不触发页面刷新，配合 popstate 事件监听浏览器前进后退操作。

基本思路：

通过 pushState 更新 URL 并记录状态
监听 popstate 事件，在用户点击前进/后退时响应路由变化
绑定页面内所有导航链接，拦截默认跳转，改为异步加载内容

示例代码片段：

function navigate(path) {
  window.history.pushState({}, '', path);
  handleRoute();
}

window.addEventListener('popstate', handleRoute);

document.addEventListener('click', e => {
  const link = e.target.closest('a[href]');
  if (link && link.hostname === window.location.hostname) {
    e.preventDefault();
    navigate(link.getAttribute('href'));
  }
});

登录后复制

实现路由匹配与视图更新

定义一个简单的路由表，将路径规则映射到处理函数或模板加载逻辑。

使用对象或数组存储路径正则与回调函数
在 handleRoute 中解析当前路径，匹配对应处理器
动态插入 HTML 内容（可通过 fetch 加载片段或预注册组件）

例如：

知我AI·PC客户端

离线运行 AI 大模型，构建你的私有个人知识库，对话式提取文件知识，保证个人文件数据安全

查看详情

const routes = [
  { path: /^\/$/, render: () => app.innerHTML = '<h1>首页</h1>' },
  { path: /^\/about$/, render: () => app.innerHTML = '<p>关于页</p>' },
  { path: /^\/user\/(.+)$/, render: match => app.innerHTML = `<p>用户：${match[1]}</p>` }
];

function handleRoute() {
  const path = window.location.pathname;
  for (const route of routes) {
    const match = path.match(route.path);
    if (match) {
      route.render(match);
      return;
    }
  }
  app.innerHTML = '<h1>404</h1>';
}

登录后复制