原生 details+summary 实现折叠展开,语义化、可访问、键盘友好;需确保 summary 为首个子元素,用 open 属性控制默认状态,CSS 通过 details/summary 选择器定制样式,动态加载时手动同步 open 状态,不支持浏览器需渐进增强。

用 details + summary 实现原生折叠展开
HTML 原生就支持折叠展开,不需要 JS 或 CSS 模拟——details 元素是专为此设计的语义化方案。它天然可访问、支持键盘(空格/回车触发)、无需监听 click 或管理状态。
常见错误是手动写 div + JS 切换 display,结果破坏语义、键盘不可用、屏幕阅读器无法识别折叠状态。
正确写法示例:
<details>
<summary>CPU 使用率(近 24h)</summary>
<ul>
<li>峰值:92%(14:37)</li>
<li>均值:38%</li>
<li>P95 延迟:127ms</li>
</ul>
</details>-
summary必须是details的第一个子元素,否则不渲染为可点击标题 - 默认收起;加
open属性可默认展开:<details open></details> - 不支持嵌套多层
details的「联动」(比如父展开时子自动展开),需 JS 补充
多指标分组时如何避免样式错乱
多个 details 并列时,浏览器默认用 margin-block-start 分隔,但指标卡片常需统一边框、背景或 hover 效果。直接套 div 容器容易撑开间距或丢失语义。
立即学习“前端免费学习笔记(深入)”;
推荐做法:
- 用
display: grid或flex布局容器,显式控制间隙:gap: 0.5rem - 给
details加border: 1px solid #e0e0e0和border-radius: 4px,再通过summary::marker隐藏原生三角或自定义 - 避免对
summary设置display: block—— 会破坏其内联行为,导致换行异常
关键 CSS 示例:
details {
border: 1px solid #e0e0e0;
border-radius: 4px;
}
summary {
padding: 0.5rem 0.75rem;
cursor: pointer;
}
summary::marker {
content: "▶ ";
}
details[open] summary::marker {
content: "▼ ";
}指标动态加载时 details 的状态怎么保持
如果指标数据异步加载(如 fetch 后插入),details 的 open 状态不会自动保留——DOM 替换后状态重置为默认(收起)。
必须手动同步状态:
- 在替换内容前,先读取当前
open属性:const wasOpen = details.hasAttribute('open'); - 插入新 DOM 后,立即恢复:
if (wasOpen) details.setAttribute('open', ''); - 不要用
details.open = true,因为属性与 JS 属性不同步,SSR 或服务端渲染时易出错 - 若用框架(如 React),需用
useEffect监听数据变化并同步open属性
IE 和旧版 Safari 不支持怎么办
details 在 IE 中完全不支持,Safari ≤ 11.1 也不支持。如果必须兼容,不能简单降级为「全展开」——用户会面对大量冗余指标。
务实方案是渐进增强:
- 检测支持:
if ('open' in document.createElement('details')) { /* 用原生 */ } - 不支持时,用最小 JS 补丁:仅添加
click事件切换aria-expanded和max-height,不重写整个交互逻辑 - 避免引入完整 UI 库(如 Bootstrap Collapse),它会增加 bundle 体积且语义更弱
- 注意:即使加了 polyfill,
details的键盘和无障碍行为也无法完全模拟,需额外测试
真正麻烦的不是代码实现,而是指标维度变多后,用户需要快速定位目标项——这时候 details 的语义结构反而比花哨动画更重要,别为了“看起来高级”放弃可访问性。



















