原生 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><span></span></code> 区别 <details><summary>1.2 表单元素</summary><p>包含 <code><input type="email"></code> 验证示例</p> </details><h3>需要动画过渡?用 <code>max-height</code> + CSS 过渡要小心</h3> <p>原生 <code>details</code> 没有展开动画,如果设计稿强制要求淡入/滑动效果,就得用 CSS 模拟——但这是妥协方案,不是首选。</p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" 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" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a rel="nofollow" href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image" class="overflowclass">AgentGen — HTML to PDF & Image</a> <p class="overflowclass">将 HTML 转换为 PDF 和图片。无需注册,免费版开箱即用(每分钟 1 次请求,含水印)。如需更高频次及去水印……</p> </div> <a rel="nofollow" href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div> <p>最大陷阱是给 <code>details</code> 直接加 <code>transition: max-height</code>,因为 <code>max-height</code> 无法从 <code>0</code> 到 <code>auto</code> 过渡,必须设固定值(比如 <code>max-height: 500px</code>),否则动画失效或卡顿。</p> <ul> <li>只对内容区(<code>details</code> 内部除 <code>summary</code> 外的部分)设 <code>max-height</code> 和 <code>overflow: hidden</code> </li> <li>用 <code>:not([open])</code> 选择器控制收起态,避免 JS 操作 class</li> <li>动画时间建议 ≤ 300ms,过长会拖慢目录浏览节奏</li> <li>移动端慎用,部分安卓 WebView 对 <code>max-height</code> 过渡支持不稳定</li> </ul> <h3>兼容旧浏览器或需复杂交互时,才考虑 JS 方案</h3> <p>如果你的课程平台必须支持 IE11,或需要记录用户上次展开的章节、配合搜索高亮、联动进度条等,那才值得引入 JS 库(如 <code>accordion</code> 组件)或手写逻辑。</p> <p>此时重点不是「怎么写展开函数」,而是「状态同步」:确保 URL hash、localStorage、服务端返回的已学状态,和 DOM 展开状态一致。否则用户刷新页面后,刚点开的章节又收起来了。</p> <ul> <li>监听 <code>toggle</code> 事件(<code>details</code> 原生事件),比监听 click 更可靠</li> <li>避免用 <code>innerHTML</code> 替换整个目录结构,会丢失当前展开状态</li> <li>如果用 React/Vue,注意 <code>details</code> 的 <code>open</code> 是受控属性,需绑定到 state</li> </ul> <p>多数课程目录不需要这么重,先用原生 <code>details</code> 跑通,再按真实反馈迭代——很多人根本没注意到有没有动画,但一定会吐槽「点开又自动收回去」或者「键盘没法操作」。</p> </div></code></p></details></details>
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










