使用 details 元素可原生实现可访问、语义化的折叠筛选栏，无需 JS；需正确使用 open 属性、summary 子元素、属性选择器定制样式，并谨慎处理嵌套与事件监听。
折叠展开用 details 元素最省事
不用写 JS、不依赖框架，原生 HTML 就能实现带分类标题的可折叠筛选栏。details 是语义化标签，内置展开/收起逻辑，浏览器默认支持，且天然适配键盘（空格/回车切换）和屏幕阅读器。
常见错误是手动用 div + JS 模拟，结果 tabindex、aria-expanded、焦点管理全漏掉，既费劲又不可访问。
-
details默认收起，加open属性可默认展开 -
summary必须是details的第一个子元素，点击它触发切换 - 内部可放任意 HTML：复选框、单选按钮、搜索输入框等筛选控件
- Chrome/Firefox/Safari/Edge 全支持，IE 不支持（需降级为静态列表）
样式定制要改 summary::marker 和 details[open]
默认箭头难看、颜色不统一？不能直接用 class 控制展开状态，得靠属性选择器和伪元素。
容易踩的坑是只写 summary { ... }，结果展开/收起时图标不动、文字没缩进、过渡动画失效。
立即学习“前端免费学习笔记（深入）”；
- 隐藏原生 marker：
summary::marker { content: ""; } - 自定义图标（如 + / −）：
summary::before { content: "▶"; }，再用details[open] summary::before { content: "▼"; } - 加过渡效果必须作用在内容区，不是
details本身：details > * { transition: max-height 0.2s ease-in-out; }，再配合overflow: hidden和动态max-height（需 JS 或 CSS 自定义属性辅助） - 移动端点按区域小？给
summary加padding，别只靠文字触发
需要 JS 控制时优先用 toggleAttribute("open")
比如“清空筛选”后自动收起所有分类，或“显示全部”一键展开——这时才需要 JS，但依然不该重做折叠逻辑。
别用 element.setAttribute("open", "") 或 removeAttribute，它们不触发浏览器内置行为，可能破坏可访问性状态。
- 正确做法：
document.querySelector("details.category-price").toggleAttribute("open"); - 监听展开事件用
toggle事件：detailsEl.addEventListener("toggle", () => { console.log(detailsEl.open); }); - 批量操作时注意：不要用
forEach遍历后统一设open = true，应逐个调用toggleAttribute，否则部分浏览器可能不触发重排 - 避免在
toggle事件里再调用toggleAttribute，会死循环
复杂筛选栏慎用嵌套 details
像“地区 → 省 → 城市 → 区县”这种多级结构，看似适合嵌套 details，但实际体验差：父级收起时子级状态丢失、键盘导航混乱、iOS Safari 有渲染 bug。
真正可用的方案是平级 details + JS 协调（例如点击“地区”后自动收起“价格”“品牌”），或者直接上轻量组件库（如 htmx + 服务端片段）。
- 嵌套后
summary的 focus 管理不可靠，用户 Tab 键可能跳过中间层级 - 没有标准方式让“父展开时子默认关闭”，得额外监听 + 手动控制，代码变重
- 如果必须嵌套，至少给每层加唯一
id和aria-controls关联，否则读屏软件无法理解层级关系
细节决定是否真能用：比如 summary 里放 input 会导致点击输入框也触发折叠，得加 event.stopPropagation()；又比如 SSR 渲染时 open 属性若由 JS 动态添加，首屏会闪动。这些都不是“会写就行”的问题。
