details+summary可实现无JS多级折叠筛选,依赖原生支持、合法嵌套结构(子details须在父details后续内容中)、data-*属性解耦层级逻辑,并通过CSS控制样式、服务端JSON同步open状态。

用 details + summary 实现无 JS 的多级折叠筛选
纯 HTML 就能跑通基础交互,适合静态商品页或 SSR 场景。浏览器原生支持,不用加载 JS 库,也避开了 Safari 对 details 动画的兼容问题。
关键点在于嵌套结构必须合法:每个 details 只能有一个 summary,子级 details 必须放在父级 details 的后续内容中(不能塞进 summary 里)。
- 错误写法:
—— 子筛选项点不开... - 正确结构:父
details→summary+ 紧跟的子details块 - 需要默认展开某一级?加
open属性,比如 - 样式控制靠 CSS:用
details[open] > summary::after换箭头图标,避免 JS 操控 class
用 data-* 属性驱动 JS 筛选逻辑,而非 DOM 层级
真实商品页往往要联动更新价格区间、库存状态、甚至 URL 参数。这时候光靠 HTML 折叠不够,但 JS 不该去遍历 DOM 树判断“当前展开的是第几级”,容易错乱。
更稳的做法是把分类层级信息直接存在元素上:
<details data-category="electronics" data-level="1"><summary>电子产品</summary><details data-category="smartphones" data-level="2"><summary>手机</summary><label><input type="checkbox" data-value="iphone" data-parent="smartphones"> iPhone</label> </details></details>
- 筛选时只读
data-value和data-parent,和视觉层级解耦 - 用户勾选“iPhone”,JS 查
data-parent="smartphones"就知道它属于“手机”这一级,再向上找data-category="smartphones"的父级data-category="electronics" - 避免因 CSS 隐藏/显示、动态插入导致 DOM 查询失效
处理移动端点击穿透和滚动冲突
在 iOS Safari 或安卓 WebView 中,details 展开后如果内容高,手指快速滑动可能误触下层选项,或滚动卡顿。
- 给
details加touch-action: manipulation,减少延迟响应 - 展开时临时禁用 body 滚动:监听
toggle事件,details[open]为真时加body { overflow: hidden },关闭时恢复 - 别用
height: 0; overflow: hidden手动做折叠动画——details自带过渡,强行覆盖反而触发重排 - 真要加动画?只对
details[open] > *设opacity和transform,不碰height
服务端渲染时注意 open 状态同步
如果商品页由后端吐出 HTML(如 PHP/Nginx SSI),用户带着筛选参数进来,得让对应层级默认展开。但别在服务端硬拼 open 字符串——容易漏掉嵌套层级判断。
- 推荐做法:后端输出一个 JSON 数据块,比如
<script type="application/json" id="init-filters">{"level1":"electronics","level2":"smartphones"}</script> - 前端 JS 启动时解析它,再用
querySelector('[data-category="smartphones"]')找到对应details并设open = true - 这样服务端只管数据,不操心 HTML 结构;前端只管渲染,不猜用户意图
- 注意:如果用了 CSP,
script[type="application/json"]是安全的,不会被执行
最易被忽略的是“多选后清空”的行为一致性:用户从二级筛选切到一级,之前选的二级值是否保留?这个逻辑不在 HTML 里,得在 JS 中明确用 data-parent 链路做依赖清理,而不是简单清空所有 checkbox。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











