原生 HTML 用 和 标签即可实现无 JS 折叠展开, 必须为 的第一个子元素,支持嵌套与任意 HTML 内容,通过 ::marker 可自定义箭头,操作 open 属性可控制状态。

用 和 最快实现折叠展开
不用写 JS,不依赖框架,原生 HTML 就能搞定。浏览器支持已很成熟(Chrome 12+、Firefox 49+、Safari 6+、Edge 79+),移动端也完全可用。
核心就是两个标签: 是容器, 是点击区域,默认显示在最前面,点它就展开/收起内部其余内容。
-
默认是收起状态;加open属性可默认展开: -
只能有一个,且必须是的第一个子元素 - 里面可以放任意 HTML 内容(文字、列表、表格、甚至嵌套另一个
) - 不支持自定义箭头图标(但可用 CSS 的
::marker或list-style覆盖,见下节)
怎么改默认三角箭头?用 ::marker 替换最干净
浏览器给 自动加了个小三角,但样式不可直接继承。老办法用 list-style: none + before 伪元素容易错位或触发重排;现在推荐用标准的 ::marker。
<style>
summary::marker {
content: "▸ ";
color: #007bff;
}
details[open] > summary::marker {
content: "▼ ";
}
</style>
-
::marker专为标记类元素设计,语义正确、兼容性好(Chrome 86+、Firefox 87+、Safari 15.4+) - 不加
[open]选择器的话,所有状态都显示同一符号 - 如果要兼容 Safari 15.3 或更旧版本,回退方案是
summary::-webkit-details-marker(仅 WebKit)
为什么点击没反应?检查这三处硬性限制
常见“点了没反应”不是 JS 问题,而是 HTML 结构或属性踩了坑:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
不在第一个子位置(比如前面有空格、注释或文本节点)→ 浏览器忽略其交互逻辑 - 父级用了
display: contents或visibility: hidden→无法正确计算可交互区域 - JS 里调用了
event.preventDefault()在summary上(比如绑了全局 click 拦截)→ 阻断了原生 toggle 行为
验证方法:临时删掉所有 JS 和 CSS,只留最简结构,看是否恢复功能。
需要 JS 控制展开状态?直接操作 open 属性就行
不需要封装函数,也不用查 DOM 再 setAttribute——现代浏览器直接读写 open 属性即可同步 UI。
<details id="faq1"><summary>Q:怎么重置状态?</summary>
A:设 open = false 即可。
</details><script>
const el = document.getElementById('faq1');
el.open = true; // 展开
el.open = false; // 收起
el.addEventListener('toggle', () => {
console.log('当前状态:', el.open); // true/false
});
</script>
- 赋值
el.open = true/false比el.setAttribute('open', '')更可靠,避免字符串类型误判 -
toggle事件只在用户手动点击时触发,JS 赋值不会触发它,适合做状态监听 - 注意:SSR 渲染时若服务端预设
open,客户端 hydrate 后需确保属性与 DOM 状态一致,否则可能闪动
真正麻烦的不是怎么写,而是 前面多了一个看不见的空格,或者 CSS 里某条 all: unset 把 marker 给清掉了——这种细节不报错,但功能就没了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










