原生 HTML 的 和 元素最快实现课程目录折叠,无需 JavaScript; 自带开合状态管理、语义正确、无障碍友好,支持嵌套实现多级目录,仅需合理使用 CSS 即可定制样式与基础交互。

用 details 和 summary 最快实现课程目录折叠
不用写一行 JavaScript,原生 HTML 就能搞定基础折叠展开。关键就是 details 元素——它自带开合状态管理,浏览器原生支持,语义正确,还自动适配屏幕阅读器。
常见错误是试图用 div + CSS 类 + JS 手动切换 display: none,既冗余又容易漏掉焦点管理、键盘操作(如回车/空格触发)、状态同步等问题。
-
details默认收起,加open属性可默认展开 -
summary必须是details的第一个子元素,点击它触发开关 - 里面可以嵌套任意 HTML:标题、图标、计时器、小标签(比如「已学」)
- 不支持 IE,但 Edge、Chrome、Firefox、Safari 均已稳定支持多年
让多级目录也能逐层折叠(嵌套 details)
课程目录常有“章节 → 小节 → 视频”三级结构。直接在 summary 里再放一个 details 即可,浏览器会正确处理嵌套逻辑和事件冒泡。
注意:别用 display: block/none 或 max-height 动画强行模拟嵌套,会导致子级无法独立控制开合,或键盘 Tab 顺序错乱。
立即学习“前端免费学习笔记(深入)”;
- 每层都用独立的
details,不要靠 JS 控制多个元素的显隐 - 用 CSS 选中器
details > summary::marker可自定义箭头(如换成「▶」「▼」) - 若需「全部展开/收起」按钮,再加轻量 JS 监听按钮并批量设置
open属性即可,不是必须的
<details>
<summary>第一章:HTML 基础</summary>
<details>
<summary>1.1 标签语法</summary>
<p>讲解 <code><div></code> 与 <code><span></code> 区别</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20cf0281539.jpg" alt="AgentGen — HTML to PDF & Image" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image">AgentGen — HTML to PDF & Image</a>
<p>将 HTML 转换为 PDF 和图片。无需注册,免费版开箱即用(每分钟 1 次请求,含水印)。如需更高频次及去水印……</p>
</div>
<a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
</details>
<details>
<summary>1.2 表单元素</summary>
<p>包含 <code><input type="email"></code> 验证示例</p>
</details>
</details>
需要动画过渡?用 max-height + CSS 过渡要小心
原生 details 没有展开动画,如果设计稿强制要求淡入/滑动效果,就得用 CSS 模拟——但这是妥协方案,不是首选。
最大陷阱是给 details 直接加 transition: max-height,因为 max-height 无法从 0 到 auto 过渡,必须设固定值(比如 max-height: 500px),否则动画失效或卡顿。
- 只对内容区(
details内部除summary外的部分)设max-height和overflow: hidden - 用
:not([open])选择器控制收起态,避免 JS 操作 class - 动画时间建议 ≤ 300ms,过长会拖慢目录浏览节奏
- 移动端慎用,部分安卓 WebView 对
max-height过渡支持不稳定
兼容旧浏览器或需复杂交互时,才考虑 JS 方案
如果你的课程平台必须支持 IE11,或需要记录用户上次展开的章节、配合搜索高亮、联动进度条等,那才值得引入 JS 库(如 accordion 组件)或手写逻辑。
此时重点不是「怎么写展开函数」,而是「状态同步」:确保 URL hash、localStorage、服务端返回的已学状态,和 DOM 展开状态一致。否则用户刷新页面后,刚点开的章节又收起来了。
- 监听
toggle事件(details原生事件),比监听 click 更可靠 - 避免用
innerHTML替换整个目录结构,会丢失当前展开状态 - 如果用 React/Vue,注意
details的open是受控属性,需绑定到 state
多数课程目录不需要这么重,先用原生 details 跑通,再按真实反馈迭代——很多人根本没注意到有没有动画,但一定会吐槽「点开又自动收回去」或者「键盘没法操作」。


















