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

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


















