先保证链接可访问和页面跳转,再用 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'));
}
});
实现路由匹配与视图更新
定义一个简单的路由表,将路径规则映射到处理函数或模板加载逻辑。
例如:
const routes = [
{ path: /^\/$/, render: () => app.innerHTML = '首页
' },
{ path: /^\/about$/, render: () => app.innerHTML = '关于页
' },
{ path: /^\/user\/(.+)$/, render: match => app.innerHTML = `用户:${match[1]}
` }
];
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 = '404
';
}
保障渐进增强:服务端支持基础路由
真正的渐进增强要求即使关闭 JavaScript,页面也能正常访问。这意味着:
- 所有链接都是真实存在的 URL,能被服务器正确响应
- 服务器配置为对所有前端路由返回同一个 HTML 入口(如 SPA 的 index.html)
- 该 HTML 文件包含带 href 的标准链接,非 JS 生成
这样,当 JS 不可用时,用户依然能通过服务端渲染完整页面;JS 启用后,系统接管导航,提升交互效率。
附加功能:标题管理与懒加载
可在路由处理器中设置 document.title,模拟不同“页面”标题变化。
- 结合
fetch()懒加载远程内容,减少首屏体积 - 添加 loading 状态提示,提升用户体验
- 考虑 hash fallback(兼容旧环境),但优先使用 history 模式
基本上就这些。关键不是写得多复杂,而是理清层次:HTML 提供可用性,JS 提供流畅性。不依赖框架反而更贴近本质,也更容易控制性能和行为。











