details和summary是HTML原生可折叠卡片方案,无需JS或CSS框架;summary必须为details首个直接子元素,点击自动切换状态,支持键盘操作与无障碍访问。

用 details 和 summary 最快实现可折叠卡片
原生 HTML 就有现成方案,不用 JS、不引 CSS 框架也能做干净的卡片折叠展开——details 元素就是干这个的。summary 是它的唯一合法子元素,点它就展开/收起内容。浏览器默认带箭头、支持键盘(空格/回车触发)、语义正确、无障碍友好。
常见错误是把它当普通容器乱套 div:比如在 details 里塞多个 summary,或用 display: none 强行隐藏内容——这会破坏原生行为,导致无法聚焦、屏幕阅读器读不出来。
-
details默认是关闭状态,加open属性可默认展开: - 箭头样式不能直接用
::marker改(仅 Firefox 支持),稳妥做法是用summary::before+content覆盖,并设list-style: none - 里面可以放任意 HTML 内容(表格、图片、表单),但避免再嵌套
details—— 多层折叠在部分 Android WebView 里有点击穿透问题
用 CSS 控制卡片外观和动效
原生 details 没有展开动画,直接突显内容。要加淡入/高度过渡,得绕一下:不能对 details 或 summary 本身设 transition,因为内部内容是“突然出现”的,没有高度变化过程。
可行做法是把实际内容包进一个 div,初始设 max-height: 0 + overflow: hidden,再用 details[open] > div 触发展开态的 max-height(设足够大值,如 500px)。注意别用 height: auto 过渡——CSS 不支持 auto 做过渡值。
- 动效时长建议 250–300ms,太快不明显,太慢拖沓
- 为兼容旧版 Safari(
details支持度从 v12.1 开始),可加@supports (display: contents)检测后降级为 JS 方案 - 卡片边框、圆角、阴影用在
details根元素上,别套在内部div上,否则展开时会跳动
需要 JS 控制时该监听什么事件
想在展开/收起时触发逻辑(比如懒加载内容、打点统计),别监听 click——用户可能用键盘操作,或者屏幕阅读器用户不点不按。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
必须监听 toggle 事件,它在每次开闭状态切换后触发,且包含 event.target.open 布尔值:
document.querySelector('details').addEventListener('toggle', (e) => {
if (e.target.open) {
console.log('卡片展开了');
}
});
-
toggle事件不冒泡,如果卡片在 Shadow DOM 里,需在内部监听 - 不要在
toggle里调e.target.open = false来阻止展开——这是无效的,原生行为不可取消 - 若需异步加载内容,应在
toggle中判断!e.target.open(即刚收起)时清理资源,避免内存泄漏
移动端点击区域小、误触多怎么优化
原生 summary 点击热区窄,尤其在小屏上手指容易点空。别只加 padding——这会让箭头偏移,视觉错乱。
- 把
summary设为display: block,再用padding扩展热区,同时用margin-left把箭头拉回视觉左侧 - 给
summary加cursor: pointer,iOS 上能避免 300ms 点击延迟 - 如果卡片内容含链接或按钮,确保它们不会抢走
summary的点击权——summary必须是顶层可交互元素,别被pointer-events: none挡住 - 测试真机:某些安卓厂商浏览器(如华为 EMUI 内置浏览器)对
details的toggle事件触发有延迟,可加touchstart作为备用钩子
细节决定是否真能用:比如 summary 里的图标用 SVG 而不是字体图标,避免某些系统下图标不随文字缩放;又比如展开后内容高度突变,可能引起页面重排,若卡片在滚动容器中,得加 contain: layout 隔离影响。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










