应优先使用+实现问答区,语义正确、键盘可用、屏幕阅读器可读“已展开/已折叠”;禁用div+onclick模拟,因其无法聚焦、不可键盘操作、无语义且易被误触。

直接用 details + summary 实现问答区,不写 JS、不引框架,语义正确、键盘可用、屏幕阅读器能读出“已展开/已折叠”状态——这是当前最稳妥的选择。
为什么不能用 div + onclick 模拟折叠?
常见错误是套个 div,加 onclick 切换 display: none。问题一堆:
- 键盘用户按
Tab焦点进不去,Enter/Space触发不了 - 屏幕阅读器不知道这是一组可切换内容,会把所有问答答案一股脑读出来
- 移动端点击热区小,划动时容易误收起(原生
summary有更可靠的事件判定) - SEO 可能降权:搜索引擎识别不出“这是 FAQ”,而
details是明确的语义化标签
summary 必须是 details 的第一个子元素
这是硬性规则,不是建议。只要前面多一个空格、一个 、一个 p 或 div 包着 summary,点击就失效——现象是:鼠标悬停无手型、键盘按空格没反应、控制台也不报错,极难排查。
✅ 正确写法:
<details> <summary>咨询提交后多久能收到回复?</summary> <p>工作日 2 小时内响应,非工作时间最迟次日 10:00 前。</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p> </details>
❌ 错误写法:
<details>
<p><summary>咨询提交后多久能收到回复?</summary></p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="DeepBI DHTML 页面生成器" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器">DeepBI DHTML 页面生成器</a>
<p>生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur</p>
</div>
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<p>……</p>
</details>(summary 被 p 包住,失去交互)
怎么让多个问答互斥展开(手风琴效果)?
原生 details 默认各自独立开关。要实现“点一个,其他自动收起”,必须加 JS 监听 toggle 事件——注意不是 click,因为 toggle 只在用户手动触发展开/收起时才发生,更精准。
关键实操点:
- 给所有
details加统一 class,比如class="faq-item" - 监听
toggle,只在event.target.open === true时执行关闭逻辑(避免刚点开又立刻关掉) - 关闭其他项时,用
el.open = false,别用removeAttribute('open')—— Safari 会不认
简版代码:
document.querySelectorAll('.faq-item').forEach(item => {
item.addEventListener('toggle', () => {
if (item.open) {
document.querySelectorAll('.faq-item').forEach(i => {
if (i !== item) i.open = false;
});
}
});
});
咨询表单嵌在展开区里要注意什么?
把 form 放进 details 展开区完全可行,但有两个易踩坑点:
-
form提交后页面跳转或刷新,会导致details自动收起——如果用户填了一半想预览,收起后内容就看不见了;建议用event.preventDefault()控制提交逻辑,或用localStorage缓存输入值 - 不要在
summary里放button或a标签——它们会劫持点击事件,导致details失去默认展开行为,且辅助技术可能报双按钮语义错误
复杂点往往藏在细节里:比如 CMS 导出富文本时自动给 summary 加 p 标签,或者构建工具压缩 HTML 时删掉了换行,让 summary 前面意外多了空白字符——这些都会让整个问答区静默失效,却没有任何提示。


















