不能用于课程大纲,因其仅支持扁平化顺序列表,无法表达章→节→小节的嵌套层级关系;正确做法是用包裹配合~构建语义化标题结构。

直接用 做课程大纲目录,结构会崩、编号不可控、语义错乱——这不是写法问题,是根本用错了标签。
为什么
不能当课程大纲用
表达的是「有顺序的条目集合」,比如操作步骤、排行榜、考试题序号。课程大纲本质是「嵌套层级结构」:章 → 节 → 小节 → 知识点,它需要语义分组和标题层级,不是简单编号。
- 把所有课时塞进一个
,浏览器只认“第1项、第2项……”,无法体现“第2章下的2.3节”这种父子关系 -
type或start属性控制的是列表项标记(marker),不是逻辑编号;一旦动态增删章节,编号极易错位 - 屏幕阅读器会把整个
当作一个扁平列表朗读,跳过章节归属信息 - SEO 和文档解析工具(如 axe)完全无法从中提取出有效的课程结构
正确做法:用 + ~ 构建层级
课程大纲的语义核心是「章节隶属关系」,HTML 里唯一能表达这个的是 heading 标签配合 sectioning root。
- 每章用一个
包裹,章标题用 - 每节课用
,必须紧跟在同个内部 - 若课时下需细分(如“讲解”“练习”),用
,禁止跳级(比如后直接) - 编号写进标题文本里:
,稳定、可搜索、打印友好第3章:JavaScript 作用域
<section><h2>第2章:CSS 布局</h2>
<h3>2.1 Flex 基础语法</h3>
<h3>2.2 Grid 网格系统</h3>
<section><h3>2.3 响应式断点实践</h3>
<h4>移动优先策略</h4>
<h4>媒体查询写法</h4>
</section></section>
想折叠展开?别硬套嵌套
原生不维护祖先状态。你点开「2.3 节」,「第2章」不会自动展开——这不是 bug,是规范行为。
- 单层大纲(如平铺所有课时)可用
<details><summary>2.3 节标题</summary>…</details>
- 多级折叠(章→节→小节)必须用 JS 监听
toggle 事件,向上遍历并设置open = true给所有祖先 -
必须是真实标题,不是“点击展开”,否则视障用户无法获知内容结构 - 初始展开态不要依赖
open属性,Safari 对缓存/返回页处理不稳定;改用 JS 在DOMContentLoaded后显式赋值
验证你做的大纲是否真有效
别信浏览器渲染效果,要查浏览器实际生成的文档大纲树。
- Chrome:装 axe DevTools 扩展 → Analyze → 查 Structure 下的
heading-order错误 - Firefox:右键检查元素 → 切到 Accessibility 面板 → 点 Outline
- 命令行:
axe-cli https://yoursite.com --rules=heading-order - 特别注意:JS 动态插入的标题,必须等组件 mount 完再验证,否则检测不到
最容易被忽略的是:大纲断裂不会让页面看起来异常,但它会让屏幕阅读器跳过整章、SEO 提取不到结构、甚至 Safari 的“文档概览”功能失效——静默失效,直到有人依赖它才暴露问题。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











