纯静态HTML分页导航需同时满足:准确识别当前页(每页手动或模板注入active/aria-current)、使用绝对路径或base标签避免404、采用nav+ol语义化结构并添加prev/next和省略号规范。

直接改 HTML 文件就能让分页导航正常工作,但必须同时满足三个条件:当前页能被准确识别、链接路径不因页面位置变化而失效、结构能让屏幕阅读器和键盘用户正常使用。硬写 <li class="active">3</li> 或用相对路径 href="page/2.html" 是最常见的失败原因。
怎么让当前页在纯 HTML 中自动高亮
静态 HTML 没有运行时判断能力,window.location 在每个页面里都不同,不能靠 JS 统一处理。唯一可靠的方式是:每个 HTML 文件里,只给指向自身的那个链接加 class="active" 和 aria-current="page"。
- 比如在
/blog/page/5.html中,只有<a href="/blog/page/5.html" class="active" aria-current="page">5</a>这一项该加标记 - 用 Hugo/Jekyll 等生成器时,用模板变量注入,如
{{ if eq .Page.Number 5 }}class="active" aria-current="page"{{ end }} - 千万别在 CSS 里写
a:hover或:focus冒充当前页状态——悬停不是位置标识,用户无法确认自己在哪一页
为什么 href 必须用绝对路径或 <base>
写成 href="page/3.html" 看似简洁,但在 /blog/post/a.html 页面点击时,浏览器会解析为 /blog/post/page/3.html,404 是必然结果。这不是 bug,是 URL 解析规则。
- 正确做法是统一用根路径:
href="/blog/page/3.html" - 如果站点部署在子路径(如
https://example.com/docs/),必须在加<base href="/docs/">,否则所有根路径都会错位 - 禁用 JS 拼接路径,例如
"page/" + (i) + ".html"——模板阶段就该确定,JS 运行时算容易出错且不可缓存
HTML 结构必须用 <nav></nav> + <ol></ol> + <li>
一堆 <div> 或 <code><span></span> 堆出来的“分页”,对键盘用户和屏幕阅读器来说就是一串无意义字符。Tab 键焦点顺序错乱、无法识别页码序列、当前页不可感知,全是结构性缺陷。
立即学习“前端免费学习笔记(深入)”;
- 外层必须是
<nav aria-label="分页导航"></nav>,这是辅助技术识别导航区域的唯一依据 - 页码项必须用
<ol></ol>(有序列表)包裹,不能用<ul></ul>或<div>;语义上页码是线性序列,不是无序集合 <li>上一页/下一页链接要带 <code>rel="prev"/rel="next",搜索引擎靠这个理解内容顺序,影响收录权重 - 当前页链接必须同时有
class="active"和aria-current="page",缺一不可
最易被忽略的点是:省略号不是装饰,是信息压缩信号。它只在跳过 ≥2 页时才该出现,比如显示 [1, '', 4, 5, 6, '', 10] 合理,但 [1, '', 2, 3, 4] 就是误导——中间根本没跳页,加省略号反而让用户怀疑漏了内容。



















