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

,且 必须是 的第一个子元素。
为什么直接写 内容
DeepBI DHTML 页面生成器
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur
下载
不生效?
因为缺少触发区域:
是唯一可点击、可聚焦、可键盘操作(空格/回车)的交互入口。没有它, 就只是个普通容器,不会响应点击,也不会显示箭头或切换状态。
-
标题
内容
—— ❌ 不是
,折叠逻辑失效
-
标题
内容
—— ✅ 正确结构
- 若省略
,浏览器会自动生成一个“Details”文字,但不可控、不语义、无样式入口
open 属性怎么用?JS 动态控制要注意什么?
open 是布尔属性:存在即为 true(展开),不存在即为 false(收起)。它控制初始状态,也支持运行时修改。
- 默认收起:
标题
...
- 默认展开:
标题
...
- JS 设置展开:
el.open = true 或 el.setAttribute('open', '')
- JS 收起:
el.open = false 或 el.removeAttribute('open')
- ⚠️ Safari 旧版本(≤15.3)对 JS 修改
open 有延迟,需加 el.offsetHeight 强制重排才能立即生效
想改箭头图标或加旋转动画,::marker 和 ::after 怎么配合?
不能删掉
的按钮语义,所以不能设 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 过渡:它不支持,强行加会失效
需要平滑高度过渡动画时,还能用 吗?
不能。原生 的展开动画由浏览器私有实现,无法用 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 更省时间。
为什么直接写 内容
DeepBI DHTML 页面生成器
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur
下载
不生效?
内容
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
因为缺少触发区域: 是唯一可点击、可聚焦、可键盘操作(空格/回车)的交互入口。没有它,
-
—— ❌标题内容
不是,折叠逻辑失效—— ✅ 正确结构标题
内容
- 若省略
,浏览器会自动生成一个“Details”文字,但不可控、不语义、无样式入口open属性怎么用?JS 动态控制要注意什么?open是布尔属性:存在即为 true(展开),不存在即为 false(收起)。它控制初始状态,也支持运行时修改。- 默认收起:
标题
... - 默认展开:
标题
... - JS 设置展开:
el.open = true或el.setAttribute('open', '') - JS 收起:
el.open = false或el.removeAttribute('open') - ⚠️ Safari 旧版本(≤15.3)对 JS 修改
open有延迟,需加el.offsetHeight强制重排才能立即生效
想改箭头图标或加旋转动画,
::marker和::after怎么配合?不能删掉
的按钮语义,所以不能设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过渡:它不支持,强行加会失效
需要平滑高度过渡动画时,还能用
吗?不能。原生
的展开动画由浏览器私有实现,无法用 CSStransition控制,也不暴露高度变化过程。真要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 更省时间。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










