details+summary仅适合静态筛选项,如固定价格区间;一旦涉及搜索、动态加载、多选同步或键盘导航(如方向键操作),必须改用ul/li+JS+aria-expanded结构。

details + summary 是最轻量、语义最正的 HTML 筛选菜单折叠方案,但仅适合静态筛选项;一旦涉及搜索过滤、动态加载、多选状态同步或键盘导航要求,就必须用 ul/li + JS 控制。
什么时候该用 details,什么时候必须放弃?
能直接用 details 的场景非常有限:
- 筛选项固定不变(比如“价格区间:¥0–50 / ¥50–200 / ¥200+”)
- 不需搜索框嵌入其中(
summary后不能插input,否则破坏语义和 Safari 行为) - 不要求键盘按 Tab 进入后用方向键操作选项
- 不关心屏幕阅读器播报“已展开 3 个筛选条件”这类上下文
只要出现“搜索”二字,基本就要切到自定义结构。因为原生 details 不支持在展开区里放可聚焦控件而不打断交互流——用户点进搜索框再按 Esc,本该收起菜单,结果只清空了输入内容。
ul + button + aria-expanded 是生产环境标配
结构上必须保证子 ul 是父 li 的**直接子元素**,否则键盘导航会跳过整个子菜单。JS 绑定点击时,只操作紧邻的下一个 ul,而不是全局查 querySelectorAll('ul'):
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
<li>
<button aria-expanded="false" aria-controls="price-menu">价格</button>
<ul id="price-menu" hidden>
<li><label><input type="checkbox"> ¥0–50</label></li>
</ul>
</li>
- 每次点击只改当前
button的aria-expanded和对应ul的hidden属性,避免误触兄弟节点 -
hidden比display: none更安全:它天然屏蔽焦点、不参与渲染、兼容所有屏幕阅读器 - 别用
toggleAttribute('hidden')—— IE11 不支持,改用el.hidden = !el.hidden
搜索栏嵌入筛选菜单的三个硬约束
把搜索框塞进展开区不是加个 input 就完事,有三处容易崩:
- 搜索框必须设
tabindex="0",否则 Tab 键无法进入;但展开前它得tabindex="-1",否则焦点会提前落在不可见区域 - 输入时要监听
input事件做防抖过滤,但不能在keyup里直接操作 DOM 渲染列表——得等过滤完成、新li插入后再调用el.focus()把焦点归位 - 移动端点击搜索框弹出软键盘时,页面可能被顶高,导致菜单顶部移出视口;得在
focus后加el.scrollIntoView({ block: 'nearest' })
最常被忽略的是:筛选菜单里的搜索框,其 aria-label 必须带上下文,比如 aria-label="在价格筛选中搜索",而不是笼统的“搜索”。否则 NVDA 会念成“搜索,编辑”,用户根本不知道这是在哪一层筛选里。


















