当前位置：首页 > news >正文

实现前端框架 SPA 路由功能：Hash 模式与 History 模式的手动实现

news 2026/2/9 11:48:36

前言

在前端框架（如 Vue.js、React 等）中，路由管理通常会配置一个 router 对象来定义 URL 路径与组件的映射关系。

路径（path）: 这是浏览器 URL 的一部分，比如 /home 或 /about。
组件（component）: 这是与该路径相关联的 Vue 组件（或其他框架的组件），如 Home.vue 或 About.vue。
代码🌰

import { createRouter, createWebHistory } from 'vue-router';
import Home from '@/components/Home.vue';
import About from '@/components/About.vue';
const routes = [{path: '/home',name: 'Home',component: Home},{path: '/about',name: 'About',component: About}
];const router = createRouter({history: createWebHistory(),routes
});export default router;

对于现代开发的项目来说，稍微复杂一点的 SPA ，都需要用到路由。而 vue-router 正是 vue 的路由标配，且 vue-router 有两种模式： hash 和 history 。

Hash模式

hash 模式是一种把前端路由的路径用井号 # 拼接在真实 url 后面的模式。当井号 # 后面的路径发生变化时，浏览器并不会重新发起请求，而是会触发 onhashchange 事件。

使用Hash模式手写实现一个简单的 SPA 路由功能：
创建了两个链接：首页 和 关于。它们分别指向 #/home 和 #/about，这两个链接通过哈希（#）实现路由。

创建了一个 div 元素，ID 为 viewrouter，用于显示根据路由变化而改变的内容。

创建一个 routes 数组，其中包含两个路由对象，每个对象有 path 和 component 属性。path 是 URL 哈希值，component 是要在视图中显示的内容。

onHashChange 函数会在哈希变化时被调用。它首先打印当前的哈希值。

遍历 routes 数组，检查当前的哈希值是否匹配路由路径。如果匹配，更新 #viewrouter 的 innerHTML 内容为相应的 component。

DOMContentLoaded 事件在初始 HTML 文档被完全加载和解析后触发，这样可以立即显示初始内容。

hashchange 事件在 URL 哈希变化时触发，确保用户点击链接时能够更新视图。

<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Document</title><style>#viewrouter{width:100px;height:100px;background-color: blue;}</style></head><body><a href="#/home">首页</a><a href="#/about">关于</a><div id="viewrouter"></div><script>const router = document.getElementById('viewrouter')const routes = [{path: '#/home',component: '这是首页'},{path: '#/about',component: '<p>这是关于</p>'},]const onHashChange = () => {console.log(location.hash)routes.forEach(item=> {if(item.path ===location.hash){router.innerHTML = item.component}});}window.addEventListener('DOMContentLoaded', onHashChange)window.addEventListener('hashchange',onHashChange)</script></body></html>

请添加图片描述

History模式

history API 是 H5 提供的新特性，允许开发者直接更改前端路由，即更新浏览器 URL 地址而不重新发起请求。

使用History模式手写实现一个简单的 SPA 路由功能

routes 数组定义了路由映射关系。每个路由对象包含 path（URL 路径）和 component（显示的内容）。
DOMContentLoaded 事件在文档完全加载和解析后触发，onLoad 函数在此时被调用。
popstate 事件在浏览器的历史记录条目改变时触发，onPopState 函数在此时被调用。
获取所有导航链接 (<a> 标签)，并为每个链接添加点击事件监听器。
点击链接时，调用 e.preventDefault() 阻止默认的浏览器跳转行为。
使用 history.pushState() 方法更新浏览器历史记录，同时改变 URL。
手动调用 onPopState() 更新视图内容。
onPopState 函数根据当前 location.pathname 查找匹配的路由。
更新 routeView 元素的 innerHTML 显示对应的组件内容。

通过 `history.pushState` 和 `popstate` 事件实现了一个简单的前端路由系统：

用户点击导航链接时，更新 URL 并阻止默认行为。
更新浏览器历史记录并根据当前路径显示相应的内容。
处理浏览器的返回按钮等历史记录操作时，重新渲染正确的内容。