原生 不支持嵌套,因 HTML5 规范未定义该行为;Chrome/Firefox 忽略内层 open 状态,Safari 不响应点击,且 必须为首个子元素;需用 JS 监听 toggle 事件并批量控制同组子面板,或改用手写 div.accordion-item 方案实现可控嵌套。

原生 <details></details> 不支持嵌套,强行写会失效
浏览器对嵌套 <details></details> 的支持极差:Chrome 和 Firefox 会忽略内层的 open 状态,Safari 直接不响应点击;更关键的是,<summary></summary> 必须是 <details></details> 的**首个子元素**,一旦中间插入另一个 <details></details>,外层折叠逻辑就中断。这不是样式问题,而是 HTML5 规范明确未定义嵌套行为 —— 所以不是“没做好”,是“根本不该这么用”。
想保留语义又需要多层折叠,得靠 JS 监听 toggle 事件
若必须沿用原生标签结构(比如为无障碍或 SEO 保留 <details></details> 语义),只能用 JS 补足缺失能力:
- 给每组父子面板加统一
data-group属性(如data-group="faq-1") - 监听父级
<details></details>的toggle事件,用querySelectorAll找到同组子级,再根据this.open批量设置其open属性 - 避免直接操作
display或hidden,否则破坏aria-expanded同步和键盘可访问性
示例片段:
document.querySelectorAll('details[data-group]').forEach(panel => {
panel.addEventListener('toggle', () => {
const group = panel.dataset.group;
document.querySelectorAll(`details[data-group="${group}"]`).forEach(child => {
if (child !== panel) child.open = panel.open;
});
});
});
真要嵌套,推荐手写 <div class="accordion-item"> 方案
<p>当子面板需独立开关、动画不同步、或内容含 <code><video></video>/<iframe></iframe> 等需生命周期管理时,原生 <details></details> 已无优势。此时应放弃语义换可控性:
立即学习“前端免费学习笔记(深入)”;
- 用
<div class="accordion-item"> 包裹标题与内容,避免语义污染 <li>CSS 控制 <code>max-height过渡(设足够大值如500px,不能用auto) - JS 中用
scrollHeight动态读取内容高度,再赋给style.maxHeight实现精准动画 - 为键盘支持,给标题加
tabindex="0",监听Enter/Space键触发切换 - 多个面板同时展开时,别忘了在 JS 中加互斥逻辑(如
querySelectorAll('.is-open').forEach(el => el.classList.remove('is-open')))
嵌套时图标和焦点容易出错
自定义箭头用 ::before 或 ::after 时,details[open] summary::after 只能旋转外层图标;子面板的图标状态不会联动 —— 必须靠 JS 切换类名驱动。例如给每个面板加 data-level="1" 和 data-level="2",再按层级批量更新 .arrow-down 类。另外,嵌套后焦点流容易断裂,Tab 键可能跳过子级标题,必须手动管理 focus() 和 tabindex 切换。



















