和是唯一原生支持折叠展开的HTML标签,但必须满足为第一个子元素等结构约束,否则失效;IE不支持,现代浏览器可用;样式可通过::before统一控制图标,动画需JS配合max-height实现。

<details></details> 和 <summary></summary> 是唯一原生支持折叠展开的 HTML 标签,不需要 JavaScript 就能工作,但必须严格满足结构约束才能生效。
为什么<details></details>点击没反应?
最常见原因是结构不合法:<summary></summary> 必须是 <details></details> 的第一个子元素,且不能省略。写成 <details><p>内容</p></details> 或 <details><div><summary>标题</summary></div></details> 都会失效。
- 正确写法:
<details><summary>标题</summary><p>内容</p></details> -
open属性可默认展开:<details open><summary>初始展开</summary></details> - IE 完全不支持,Safari 6+、Chrome 12+、Firefox 49+、Edge 79+ 可用
- 若给
<summary></summary>设了display: flex或pointer-events: none,视觉或交互可能异常,但功能本身仍存在
<summary></summary> 的样式怎么改?
浏览器默认加了个小三角(::marker),但 Firefox 不支持该伪元素,所以靠它统一改图标不可靠。更稳妥的方式是用 ::before 替换:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
- 隐藏原生箭头:
summary::marker { content: none; }(仅 Chrome/Safari 有效) - 统一加自定义图标:
summary::before { content: "▶"; margin-right: 6px; } - 展开时切换图标:
details[open] summary::before { content: "▼"; } - 不要给
<summary></summary>设overflow: hidden,否则文字可能被裁剪
想加滑动动画,<details></details> 能直接做吗?
不能。<details></details> 原生只做显隐切换,没有高度过渡。CSS 的 transition 对 height: auto 或 display 无效,所以必须绕开原生行为,用 JS 控制 max-height:
- 监听
toggle事件:details.addEventListener('toggle', handler) - 展开前先设
max-height: 0,再读一次offsetHeight强制重排 - 然后设
max-height: element.scrollHeight + 'px' - 收起时反过来,最后可清掉
max-height避免影响后续 JS 计算 - 硬编码值(如
max-height: 500px)更简单,但内容超长会被截断
真正难的不是写出来,而是判断要不要动它——90% 的文档类折叠,<details></details> 开箱即用;一旦需要动画、记忆状态、多级联动或兼容 IE,就得切到 JS + max-height 方案,这时候别硬套原生标签,直接从 <div> 结构起步更干净。</div>


















