必须配对使用,且必须是其第一个子元素;缺少则无交互入口、不显示箭头、无法折叠展开。

,且 必须是 的第一个子元素。
为什么直接写 <details><p>内容</p>
<p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="DeepBI DHTML 页面生成器" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器">DeepBI DHTML 页面生成器</a>
<p>生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur</p>
</div>
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div></details> 不生效?
因为缺少触发区域:<summary></summary> 是唯一可点击、可聚焦、可键盘操作(空格/回车)的交互入口。没有它, 就只是个普通容器,不会响应点击,也不会显示箭头或切换状态。
-
<details><div>标题</div>
<p>内容</p>
<p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p></details> —— ❌ <div> 不是 <code><summary></summary>,折叠逻辑失效
-
<details><summary>标题</summary><p>内容</p>
<p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p></details> —— ✅ 正确结构
- 若省略
<summary></summary>,浏览器会自动生成一个“Details”文字,但不可控、不语义、无样式入口
open 属性怎么用?JS 动态控制要注意什么?
open 是布尔属性:存在即为 true(展开),不存在即为 false(收起)。它控制初始状态,也支持运行时修改。
- 默认收起:
<details><summary>标题</summary>...</details>
- 默认展开:
<details open><summary>标题</summary>...</details>
- JS 设置展开:
el.open = true 或 el.setAttribute('open', '')
- JS 收起:
el.open = false 或 el.removeAttribute('open')
- ⚠️ Safari 旧版本(≤15.3)对 JS 修改
open 有延迟,需加 el.offsetHeight 强制重排才能立即生效
想改箭头图标或加旋转动画,::marker 和 ::after 怎么配合?
不能删掉 <summary></summary> 的按钮语义,所以不能设 display: block;改图标要用伪元素,但兼容性要分场景处理。
- 隐藏原生箭头:
summary { list-style: none; }(全浏览器安全)
- 补自定义图标(Chrome/Firefox):
summary::after { content: "▶"; margin-left: 8px; transition: transform 0.2s; }
- 展开时旋转:
details[open] summary::after { transform: rotate(90deg); }
- Safari ≤15.4 不支持
::marker,且 ::after 在某些版本中可能不触发 transition —— 建议 fallback 用 summary::before + appearance: none + background image
- 别给
details 写 height 过渡:它不支持,强行加会失效
需要平滑高度过渡动画时,还能用 <details></details> 吗?
不能。原生 的展开动画由浏览器私有实现,无法用 CSS transition 控制,也不暴露高度变化过程。真要 max-height 渐变、淡入、或内容高度动态不可预估,就得放弃原生方案。
- 原生优势:无障碍(ARIA 自动注入)、键盘支持、零 JS、SEO 友好、轻量
- 动画需求强时,换 JS +
max-height 方案:先设 max-height: 0,再读取 element.scrollHeight,赋值后触发 transition
- 注意:
max-height: auto 无法过渡,必须是具体数值(如 500px)或用 JS 动态写入 scrollHeight
- 嵌套 在部分浏览器(尤其是 Safari)中行为异常,不建议多层折叠
details 和 summary 的边界很清晰:它是语义化折叠的“最小可行解”,不是万能手风琴组件。该用的时候一写就成,不该硬撑的时候,及时切到 JS + CSS 方案,比修一堆 ::marker 兼容性 bug 更省时间。
为什么直接写 <details><p>内容</p>
<p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="DeepBI DHTML 页面生成器" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器">DeepBI DHTML 页面生成器</a>
<p>生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur</p>
</div>
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div></details> 不生效?
因为缺少触发区域:<summary></summary> 是唯一可点击、可聚焦、可键盘操作(空格/回车)的交互入口。没有它,
-
<details><div>标题</div> <p>内容</p> <p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p></details>—— ❌<div> 不是 <code><summary></summary>,折叠逻辑失效 -
<details><summary>标题</summary><p>内容</p> <p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p></details>—— ✅ 正确结构 - 若省略
<summary></summary>,浏览器会自动生成一个“Details”文字,但不可控、不语义、无样式入口 - 默认收起:
<details><summary>标题</summary>...</details> - 默认展开:
<details open><summary>标题</summary>...</details> - JS 设置展开:
el.open = true或el.setAttribute('open', '') - JS 收起:
el.open = false或el.removeAttribute('open') - ⚠️ Safari 旧版本(≤15.3)对 JS 修改
open有延迟,需加el.offsetHeight强制重排才能立即生效 - 隐藏原生箭头:
summary { list-style: none; }(全浏览器安全) - 补自定义图标(Chrome/Firefox):
summary::after { content: "▶"; margin-left: 8px; transition: transform 0.2s; } - 展开时旋转:
details[open] summary::after { transform: rotate(90deg); } - Safari ≤15.4 不支持
::marker,且::after在某些版本中可能不触发 transition —— 建议 fallback 用summary::before+appearance: none+ background image - 别给
details写height过渡:它不支持,强行加会失效 - 原生优势:无障碍(ARIA 自动注入)、键盘支持、零 JS、SEO 友好、轻量
- 动画需求强时,换 JS +
max-height方案:先设max-height: 0,再读取element.scrollHeight,赋值后触发 transition - 注意:
max-height: auto无法过渡,必须是具体数值(如500px)或用 JS 动态写入scrollHeight - 嵌套 在部分浏览器(尤其是 Safari)中行为异常,不建议多层折叠
open 属性怎么用?JS 动态控制要注意什么?
open 是布尔属性:存在即为 true(展开),不存在即为 false(收起)。它控制初始状态,也支持运行时修改。
想改箭头图标或加旋转动画,::marker 和 ::after 怎么配合?
不能删掉 <summary></summary> 的按钮语义,所以不能设 display: block;改图标要用伪元素,但兼容性要分场景处理。
需要平滑高度过渡动画时,还能用 <details></details> 吗?
不能。原生 transition 控制,也不暴露高度变化过程。真要 max-height 渐变、淡入、或内容高度动态不可预估,就得放弃原生方案。
details 和 summary 的边界很清晰:它是语义化折叠的“最小可行解”,不是万能手风琴组件。该用的时候一写就成,不该硬撑的时候,及时切到 JS + CSS 方案,比修一堆 ::marker 兼容性 bug 更省时间。


















