最直接的解法是用 + 实现原生折叠,语义正确、键盘可访问、全浏览器支持;需避免常见错误如非首子元素、display:none隐藏或对height: auto设过渡。

是最直接的解法,不用写一行 JavaScript,语义正确、键盘可访问、主流浏览器全支持。
用 +
实现原生折叠
这是 HTML5 原生方案,浏览器自动处理状态切换和焦点逻辑:
<details><summary>标题</summary><p>隐藏内容</p></details><p>常见错误包括:</p>
不是 的第一个子元素 → 折叠失效
- 在
上加了 style="display: none" → 彻底隐藏,失去交互能力
- 试图给
设置 transition: height → 无效,height: auto 不支持过渡
默认收起;加 open 属性即默认展开:。Safari 对 ::marker 支持弱,若要自定义箭头图标,建议用 summary::before 配合 transform 和 transition。
需要平滑动画?用 max-height + overflow: hidden
原生 没有 CSS 动画,要实现“缓慢展开”效果,得手动控制高度过渡。核心限制是:CSS 无法对 height: auto 做过渡,所以必须用 max-height 模拟。
实操要点:
DeepBI DHTML 页面生成器
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur
下载
- 设一个足够大的
max-height(如 600px),确保内容不被截断
- 收起时设
max-height: 0,并配 overflow: hidden
- 过渡写在
max-height 上:transition: max-height 0.3s ease
- 别用
display: none/block 切换——会破坏动画,也难做过渡
示例结构:
…
,再用 JS 切换 .content 的 max-height 值。
点击表格首行控制整表数据行显隐
这不是通用折叠,而是特定 DOM 结构下的状态联动。关键不是监听 ,而是精准绑定到首行 ,再操作后续所有 元素。
JS 里应这样处理:
- 用
document.getElementById("myTable").rows 获取所有行
- 从索引
1 开始遍历(跳过首行表头)
- 对每行设置
row.style.display = row.style.display === "none" ? "" : "none"
- 不要提前在 HTML 中写
style="display:none" ——初始状态由 JS 控制更可控
如果表格含分页或动态插入行,记得每次更新后重新绑定事件或改用事件委托。
为什么别急着写 JS 控制 display?
手写 element.style.display = "none" 看似简单,但容易埋坑:
- 覆盖 CSS 文件里的
display 声明(比如媒体查询设的 display: table-row),后续调试难定位
- 无法与 CSS 过渡配合,动画只能靠 JS 定时器模拟,体验差
- 忽略键盘操作(空格/回车触发)、屏幕阅读器识别等可访问性要求
- 多层嵌套折叠时,状态管理迅速失控
真正该纠结的不是“怎么让内容消失”,而是“怎么让状态可预测、可维护、可访问”。原生 已经帮你做了大部分事,除非设计强制要求动画或特殊布局,否则别绕开它。
+
实现原生折叠 不是 的第一个子元素 → 折叠失效
上加了 style="display: none" → 彻底隐藏,失去交互能力 设置 transition: height → 无效,height: auto 不支持过渡open 属性即默认展开:。Safari 对 ::marker 支持弱,若要自定义箭头图标,建议用 summary::before 配合 transform 和 transition。max-height + overflow: hidden
没有 CSS 动画,要实现“缓慢展开”效果,得手动控制高度过渡。核心限制是:CSS 无法对 height: auto 做过渡,所以必须用 max-height 模拟。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
max-height(如 600px),确保内容不被截断max-height: 0,并配 overflow: hidden
max-height 上:transition: max-height 0.3s ease
display: none/block 切换——会破坏动画,也难做过渡
…
,再用 JS 切换 .content 的 max-height 值。,而是精准绑定到首行 ,再操作后续所有 元素。
JS 里应这样处理:
- 用
document.getElementById("myTable").rows 获取所有行
- 从索引
1 开始遍历(跳过首行表头)
- 对每行设置
row.style.display = row.style.display === "none" ? "" : "none"
- 不要提前在 HTML 中写
style="display:none" ——初始状态由 JS 控制更可控
如果表格含分页或动态插入行,记得每次更新后重新绑定事件或改用事件委托。
为什么别急着写 JS 控制 display?
手写 element.style.display = "none" 看似简单,但容易埋坑:
- 覆盖 CSS 文件里的
display 声明(比如媒体查询设的 display: table-row),后续调试难定位
- 无法与 CSS 过渡配合,动画只能靠 JS 定时器模拟,体验差
- 忽略键盘操作(空格/回车触发)、屏幕阅读器识别等可访问性要求
- 多层嵌套折叠时,状态管理迅速失控
真正该纠结的不是“怎么让内容消失”,而是“怎么让状态可预测、可维护、可访问”。原生 已经帮你做了大部分事,除非设计强制要求动画或特殊布局,否则别绕开它。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










