HTML哈希支持前端路由吗_HTML哈希和前端路由原理【详解】

秋浩姑娘_9199

秋浩姑娘_9199

2026-04-04

615人浏览

原创

location.hash 能做路由是因为修改它不刷新页面、触发hashchange事件、存入历史栈且服务端不可见;需监听load和hashchange事件并手动解析hash值。

html哈希支持前端路由吗_html哈希和前端路由原理【详解】

location.hash 支持前端路由,而且是最早、最轻量、兼容性最强的实现方式之一。它不需要服务端配合,也不依赖 HTML5 新特性,IE8 都能跑。

为什么 location.hash 能做路由?

浏览器对 URL 中 # 后面的部分(即 hash)有特殊处理: - 修改 window.location.hash 不触发页面刷新 - 每次 hash 变化都会触发 hashchange 事件 - 浏览器会把每次 hash 变化记入历史栈,支持前进/后退 - 服务端完全收不到 hash 部分,所以无需 Nginx 或后端路由配置

常见错误现象:

  • 直接改 location.href = 'xxx#about' 而不是 location.hash = 'about',导致整页跳转
  • 忘了在页面加载时手动执行一次路由匹配(load 事件里没调 refresh()),导致首次访问 #about 页面不渲染
  • 使用 addEventListener('hashchange', handler) 但没用 .bind(this) 或箭头函数,导致 this 指向丢失

无序列表说明关键点:

  • hash 值始终是字符串,包括开头的 #,实际取值要用 location.hash.slice(1)
  • hashchange 事件不冒泡,也不能取消,默认行为就是更新地址栏
  • 如果 URL 是 @#@#@#@#@#@#@#@#@#@0,location.hash 拿到的是 #user/123,不是 user/123
  • 单页应用中,history.pushState 和 location.hash 不能混用,否则历史栈会混乱

hashchange 事件监听要注意什么?

这个事件看似简单,但几个细节不注意就会漏掉首次加载或状态不同步: - 它只在 hash 真正变化时触发,页面首次加载带 hash 不会自动触发(必须手动模拟一次) - 它不区分是 JS 修改还是用户点击链接引起的变更,统一响应 - 在 iframe 里修改父页面 hash,父页面的 hashchange 仍会触发

推荐写法(兼顾首次加载和后续变更):

HTML汇报生成器
HTML汇报生成器

🚀 不用写一行代码!把项目总结、工作汇报、研究报告、技术文档、提案、数据看板直接变精美HTML。12种主题 × 11种背景动效 × 9种鼠标特效 × 10种边框样式 × 实时调色器 × 毛玻璃卡片 × PDF导出,生成后还能自由调色,零门槛AI直出。触发词:项目总结、工作汇报、PPT、生成报告、做个总结、HTML文档、数据报告、流程文档、会议纪要、技术文档、研究报告、数据看板、提案、做个展示页、帮我做个汇报、文档生成。

下载
function onHashChange() {
  const path = location.hash.slice(1) || '/';
  renderView(path);
}
<p>window.addEventListener('load', onHashChange);
window.addEventListener('hashchange', onHashChange);</p>

不要只监听 hashchange,漏掉 load 就会导致用户直接访问 @#@#@#@#@#@#@#@#@#@1 时页面空白。

Hash 模式 vs History 模式:什么时候该选 hash?

不是“哪个更高级就选哪个”,而是看部署环境和兼容需求: - 静态托管(如 GitHub Pages、Netlify、Vercel)没后端路由能力 → 必须用 hash 模式 - 项目要支持 IE9 或更低版本 → 只能用 hash 模式 - 开发阶段想快速验证路由逻辑,不想配 Nginx rewrite 规则 → hash 更省事 - 你用的是 create-react-app 或 vue-cli 默认模板,且没改 vueRouter 的 mode → 默认就是 hash

容易踩的坑:

  • 把 hash 路由当成“临时方案”随便写,结果上线后发现 SEO 友好性差、分享链接带 # 显得不专业
  • 在 history 模式下 fallback 配置出错(比如 Nginx 返回 404 而不是 index.html),又没回退到 hash 模式,导致所有深层路径白屏
  • 误以为 hash 模式不能做参数传递——其实 #user?id=123&tab=profile 完全合法,只是解析得自己处理 search 部分

最常被忽略的一点:hash 模式下,location.pathname 始终是原始路径(比如 /index.html),不会随 hash 改变。如果你在代码里混用了 pathname 和 hash 做判断,逻辑很容易错乱。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

路由优化大师
路由优化大师

路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

html 前端

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2543

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

5523

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6550

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

6178

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

883

5

html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

6335

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

3552

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

3210

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

3239

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 224人学习