FAQ 页面最怕一长串问答铺到底,读者得滚很久才能找到想看的。做成折叠面板(也叫手风琴)——只显示问题,点一下展开答案,页面立刻清爽,信息密度还更高。
这套代码纯 CSS + 一小段 JS,一个 div 就能用。下面每块都能点「预览效果」直接看,建议实际点几下试试手感。
原版 · 实际效果
<style>
.t7{font-family:system-ui,-apple-system,"PingFang SC",sans-serif;max-width:520px}
.t7-i{border:1px solid #eef2f7;border-radius:10px;margin-bottom:6px;overflow:hidden;transition:.2s}
.t7-i.on{border-color:#c7d2fe;box-shadow:0 2px 8px rgba(76,110,245,.07)}
.t7-h{display:flex;justify-content:space-between;align-items:center;padding:9px 11px;
font-size:11px;color:#141a24;cursor:pointer;font-weight:600}
.t7-i.on .t7-h{color:#4c6ef5;background:#fafbff}
.t7-a{width:9px;height:9px;flex:none;position:relative;transition:.3s}
.t7-a::before,.t7-a::after{content:"";position:absolute;background:#94a3b8;
border-radius:1px;transition:.3s}
.t7-a::before{left:0;right:0;top:4px;height:1.5px}
.t7-a::after{top:0;bottom:0;left:4px;width:1.5px}
.t7-i.on .t7-a{transform:rotate(180deg)}
.t7-i.on .t7-a::after{opacity:0}
.t7-i.on .t7-a::before{background:#4c6ef5}
.t7-c{display:none;padding:0 11px 11px;font-size:10px;color:#64748b;line-height:1.75}
.t7-i.on .t7-c{display:block;animation:t7i .3s ease}
@keyframes t7i{from{opacity:0;transform:translateY(-4px)}to{opacity:1;transform:none}}
</style>
<div class="t7" id="t7a">
<div class="t7-i on"><div class="t7-h">如何订阅更新?<span class="t7-a"></span></div>
<div class="t7-c">在侧边栏输入邮箱,每周三会收到一封摘要邮件,随时可退订。</div></div>
<div class="t7-i"><div class="t7-h">支持哪些代码高亮?<span class="t7-a"></span></div>
<div class="t7-c">支持 HTML、CSS、JavaScript、PHP、Python 等常见语言,自动识别语言类型。</div></div>
<div class="t7-i"><div class="t7-h">可以转载文章吗?<span class="t7-a"></span></div>
<div class="t7-c">可以,采用 CC BY-NC-SA 4.0 协议,署名并注明出处即可。</div></div>
<div class="t7-i"><div class="t7-h">如何联系作者?<span class="t7-a"></span></div>
<div class="t7-c">通过关于页的邮箱,或在任意文章下留言。</div></div>
</div>
<script>
(function(){
var is=document.querySelectorAll('#t7a .t7-i');
is.forEach(function(i){
i.querySelector('.t7-h').onclick=function(){
var on=i.classList.contains('on');
is.forEach(function(x){x.classList.remove('on')});
if(!on)i.classList.add('on');
};
});
})();
</script>原版代码的问题:鼠标点击确实能展开收起,功能是正常的。但它完全不支持键盘(Tab 聚焦不到、回车没反应),读屏也不知道当前是展开还是收起,而且内嵌的 script 在加了安全策略的站点上会被整体拦截。
① 最严重的:完全不支持键盘
问题标题用的是 <div>,我实测:
| 检查项 | 结果 |
|---|---|
| 元素 | DIV |
tabindex |
-1(不可聚焦) |
| Tab 能否聚焦 | 否 |
<button> 数量 |
0 |
aria-expanded |
0 个 |
aria-controls |
0 个 |
键盘用户完全打不开这些答案。Tab 键跳不过去,即使跳过去了按回车也没反应。同理读屏软件也不知道"这是一个可展开的按钮",更不知道当前是展开还是收起状态。
cursor:pointer 只改了鼠标光标外观,跟能不能用键盘没关系——这跟前面几篇里"无 href 的假链接"是同一类问题。
② 内嵌 <script> 在加了安全策略的站点上会被整体拦截
这块代码把 JS 直接写在 HTML 里。我做了对照实验,同一个页面只差一条 CSP 头:
| 点击第 2 项后是否展开 | |
|---|---|
| 无 CSP | 展开成功 ✓ |
有 CSP(script-src 'self') |
毫无反应 ✗ |
浏览器报的是:
Executing inline script violates the following Content Security Policy directive
注意这个跟内联 onclick 是同一种拦截——只要是写在 HTML 里的脚本(不管 <script> 块还是 onclick 属性)都会被拦。很多安全插件、CDN 防护都会加 CSP,本地能跑、上线失效,最难查。
③ 展开态标题对比度 4.18,差一点达标
| 元素 | 配色 | 对比度 | |
|---|---|---|---|
| 问题标题(收起) | #141a24 on 白 |
17.46 | ✓ |
| 问题标题(展开) | #4c6ef5 on #fafbff |
4.18 | ✗ |
| 答案正文 | #64748b on 白 |
4.76 | ✓ |
| 加号图标 | #94a3b8 on 白 |
2.56 | △ |
展开态的蓝色标题差 0.32 就到 4.5。加号图标只有 2.56,虽然它是图形(不适用文字的 4.5 标准),但线条只有 1.5px 粗,这个对比度下几乎看不清。
④ 字号偏小
实测问题标题 11px、答案正文 10px。中文笔画密度高,10px 基本糊了。而且部分安卓浏览器有「最小字号」设置,会强制放大导致布局错乱。
⑤ 展开有动画,收起是瞬间消失
@keyframes t7i 只作用在 .t7-i.on .t7-c 上,展开时有淡入上移,收起时 display:none 直接消失。一进一出不对称,观感有点突兀。
⑥ 三个小问题
transition:.2s没指定属性,等价于transition:all- 没有
prefers-reduced-motion,开启系统减弱动效后动画照跑 - 开头那句
body{margin:0;padding:14px;font:...;background:#fff}会污染整站——粘进站点等于把整站边距、字体、背景全刷一遍。下面所有代码块都删掉了,照抄时不要加回去
修复版 · 用 button + 完整 ARIA
<style>
.wxz-fq{--c:#3b5bdb;--line:#e8edf5;--txt:#3f4a5a;
max-width:520px;font-family:system-ui,-apple-system,"PingFang SC",sans-serif}
.wxz-fq .item{border:1px solid var(--line);border-radius:11px;margin-bottom:7px;
overflow:hidden;transition:border-color .2s,box-shadow .2s}
.wxz-fq .item.open{border-color:#c7d2fe;box-shadow:0 2px 8px rgba(76,110,245,.07)}
/* 关键:用 button 而不是 div —— 天生可聚焦、回车空格可触发 */
.wxz-fq .q{display:flex;justify-content:space-between;align-items:center;gap:10px;
width:100%;padding:12px 13px;border:0;background:#fff;cursor:pointer;
font:inherit;font-size:13.5px;font-weight:600;color:#1f2937;text-align:left}
.wxz-fq .item.open .q{color:var(--c);background:#eff6ff} /* 对比度 5.21 ✓ */
.wxz-fq .q:focus-visible{outline:2px solid var(--c);outline-offset:-2px}
/* 箭头用 CSS 边框画,跟着状态转 */
.wxz-fq .ar{flex:none;width:9px;height:9px;border-right:2px solid #64748b;
border-bottom:2px solid #64748b;transform:rotate(45deg);transition:transform .3s;
margin-right:2px}
.wxz-fq .item.open .ar{transform:rotate(-135deg);border-color:var(--c)}
/* 高度动画:0fr → 1fr,展开收起都平滑 */
.wxz-fq .a{display:grid;grid-template-rows:0fr;transition:grid-template-rows .32s ease}
.wxz-fq .item.open .a{grid-template-rows:1fr}
.wxz-fq .a > div{overflow:hidden}
.wxz-fq .a p{margin:0;padding:0 13px 13px;font-size:13px;color:#556070;line-height:1.75} /* 6.38 ✓ */
@media (prefers-reduced-motion:reduce){
.wxz-fq .item,.wxz-fq .ar,.wxz-fq .a{transition:none}
}
</style>
<div class="wxz-fq" id="fq1">
<div class="item open">
<button type="button" class="q" aria-expanded="true" aria-controls="fq1a1">
如何订阅更新?<span class="ar" aria-hidden="true"></span></button>
<div class="a" id="fq1a1" role="region"><div><p>在侧边栏输入邮箱,每周三会收到一封摘要邮件,随时可退订。</p></div></div>
</div>
<div class="item">
<button type="button" class="q" aria-expanded="false" aria-controls="fq1a2">
支持哪些代码高亮?<span class="ar" aria-hidden="true"></span></button>
<div class="a" id="fq1a2" role="region"><div><p>支持 HTML、CSS、JavaScript、PHP、Python 等常见语言,自动识别语言类型。</p></div></div>
</div>
<div class="item">
<button type="button" class="q" aria-expanded="false" aria-controls="fq1a3">
可以转载文章吗?<span class="ar" aria-hidden="true"></span></button>
<div class="a" id="fq1a3" role="region"><div><p>可以,采用 CC BY-NC-SA 4.0 协议,署名并注明出处即可。</p></div></div>
</div>
<div class="item">
<button type="button" class="q" aria-expanded="false" aria-controls="fq1a4">
如何联系作者?<span class="ar" aria-hidden="true"></span></button>
<div class="a" id="fq1a4" role="region"><div><p>通过关于页的邮箱,或在任意文章下留言。</p></div></div>
</div>
</div>
<script>
(function () {
var root = document.getElementById('fq1');
if (!root) return;
var items = root.querySelectorAll('.item');
items.forEach(function (item) {
var btn = item.querySelector('.q');
btn.addEventListener('click', function () {
var willOpen = !item.classList.contains('open');
items.forEach(function (x) {
x.classList.remove('open');
x.querySelector('.q').setAttribute('aria-expanded', 'false');
});
if (willOpen) {
item.classList.add('open');
btn.setAttribute('aria-expanded', 'true');
}
});
});
})();
</script>这版改了这些:问题标题换成真 button(可 Tab 聚焦、回车/空格可展开)、加 aria-expanded 与 aria-controls 让读屏知道状态、展开态标题对比度修到 5.48、字号提到 13px、展开收起都用 grid 高度动画。
改了这些,每项都有实测支撑:
| 改动 | 作用 | 实测 |
|---|---|---|
<div> → <button type="button"> |
可 Tab 聚焦、回车/空格可触发 | tabindex -1 → 0,可聚焦 ✓ |
加 aria-expanded |
读屏播报展开/收起状态 | 0 → 4 个 ✓ |
加 aria-controls + role="region" |
把问题和答案关联起来 | 0 → 4 组 ✓ |
展开态标题 → #3b5bdb |
对比度达标 | 4.18 → 5.21 ✓ |
| 字号 11/10px → 13.5/13px | 中文不再糊 | — |
| 加号改 CSS 边框画(2px 粗) | 比 1.5px 的伪元素更清晰 | 线宽 1.5px → 2px |
高度动画改 grid-template-rows: 0fr→1fr |
展开收起都平滑,不再一边有动画一边瞬跳 | 实测高度 0→14→40→60→72→79→81→83 渐变 ✓ |
补 prefers-reduced-motion |
尊重系统减弱动效 | — |
关于 grid-template-rows 这个技巧:display:none 没法做过渡动画,max-height 又需要猜一个固定值(内容多了会被截断)。用 grid 的 0fr → 1fr 可以让高度自适应内容地平滑过渡,实测采样高度是逐帧递增的。这是目前做折叠动画最干净的办法,Chrome 107+ / Firefox 66+ / Safari 16+ 支持。
关于 aria-e:它加在 <button> 上,值随状态切换 true/false。读屏软件会播报"折叠"或"已展开",用户不用猜。aria-controls` 指向答案区的 id,把两者关联起来。
原生版 · 零 JS 方案
其实浏览器自带了折叠元素——<details> / <summary>。不用写一行 JS,键盘、读屏、展开收起全都是原生支持的。
<style>
.wxz-dt{max-width:520px;font-family:system-ui,-apple-system,"PingFang SC",sans-serif}
.wxz-dt details{border:1px solid #e8edf5;border-radius:11px;margin-bottom:7px;
overflow:hidden;transition:border-color .2s,box-shadow .2s}
.wxz-dt details[open]{border-color:#c7d2fe;box-shadow:0 2px 8px rgba(76,110,245,.07)}
.wxz-dt summary{display:flex;justify-content:space-between;align-items:center;gap:10px;
padding:12px 13px;cursor:pointer;font-size:13.5px;font-weight:600;color:#1f2937;
list-style:none} /* 去掉默认三角 */
.wxz-dt summary::-webkit-details-marker{display:none}
.wxz-dt details[open] summary{color:#3b5bdb;background:#eff6ff}
.wxz-dt summary:focus-visible{outline:2px solid #3b5bdb;outline-offset:-2px}
.wxz-dt .ar{flex:none;width:9px;height:9px;border-right:2px solid #64748b;
border-bottom:2px solid #64748b;transform:rotate(45deg);transition:transform .3s;margin-right:2px}
.wxz-dt details[open] .ar{transform:rotate(-135deg);border-color:#3b5bdb}
.wxz-dt .body{padding:0 13px 13px;font-size:13px;color:#556070;line-height:1.75}
@media (prefers-reduced-motion:reduce){
.wxz-dt details,.wxz-dt .ar{transition:none}
}
</style>
<div class="wxz-dt">
<details open>
<summary>如何订阅更新?<span class="ar" aria-hidden="true"></span></summary>
<div class="body">在侧边栏输入邮箱,每周三会收到一封摘要邮件,随时可退订。</div>
</details>
<details>
<summary>支持哪些代码高亮?<span class="ar" aria-hidden="true"></span></summary>
<div class="body">支持 HTML、CSS、JavaScript、PHP、Python 等常见语言,自动识别语言类型。</div>
</details>
<details>
<summary>可以转载文章吗?<span class="ar" aria-hidden="true"></span></summary>
<div class="body">可以,采用 CC BY-NC-SA 4.0 协议,署名并注明出处即可。</div>
</details>
<details>
<summary>如何联系作者?<span class="ar" aria-hidden="true"></span></summary>
<div class="body">通过关于页的邮箱,或在任意文章下留言。</div>
</details>
</div>原生 details:用 details 和 summary 标签,不用写一行 JS。我实测过 —— summary 天生可 Tab 聚焦、按回车就能展开,读屏也能正确识别。想要「同时只开一个」的效果,文末给了几行可选 JS。
我实测了原生元素的可访问性,全部是开箱即有的:
| 检查项 | 结果 |
|---|---|
summary 的 tabIndex |
0(天生可聚焦) |
| Tab 能否聚焦 | 能 ✓ |
| 按回车能否展开 | 能 ✓ |
| 读屏识别 | 原生支持 ✓ |
这些在原版里全是"否"。所以能用 <details> 就尽量用它——省掉 JS,还不用担心 CSP 拦截。
有一点要说明:原生版不需要也不应该再加 aria-expanded——<details> 自己就会向读屏暴露展开状态(所以上面实测里它是 0 个,这是对的,不是漏了)。反过来,如果是自己用 <button> 写的版本,就必须手动加。
两个细节:
list-style:none+::-webkit-details-marker{display:none}用来去掉浏览器默认三角,好换成自己的箭头。两条都要写,前者管 Firefox,后者管 WebKit。- 想要"同时只开一个"的话,加几行 JS(可选,不写也能正常用):
```js
document.querySelectorAll('.dt details').forEach(function (d) {
d.addEventListener('toggle', function () {
if (d.open) {
document.querySelectorAll('.dt details').forEach(function (o) {
if (o !== d) o.removeAttribute('open');
});
}
});
});
```
用 toggle 事件而不是 click,这样键盘操作也能触发。
深色款 · 配暗色主题
<style>
.wxz-fqd{--c:#90cdf4;--line:#2d3748;--bg:#232a38;
max-width:520px;font-family:system-ui,-apple-system,"PingFang SC",sans-serif;
background:#1a202c;padding:14px;border-radius:12px}
.wxz-fqd .item{border:1px solid var(--line);border-radius:11px;margin-bottom:7px;
overflow:hidden;background:var(--bg);transition:border-color .2s}
.wxz-fqd .item.open{border-color:#3182ce}
.wxz-fqd .q{display:flex;justify-content:space-between;align-items:center;gap:10px;
width:100%;padding:12px 13px;border:0;background:transparent;cursor:pointer;
font:inherit;font-size:13.5px;font-weight:600;color:#cbd5e0;text-align:left} /* 10.98 ✓ */
.wxz-fqd .item.open .q{color:var(--c);background:#1e3450} /* 9.50 ✓ */
.wxz-fqd .q:focus-visible{outline:2px solid #90cdf4;outline-offset:-2px}
.wxz-fqd .ar{flex:none;width:9px;height:9px;border-right:2px solid #a0aec0;
border-bottom:2px solid #a0aec0;transform:rotate(45deg);transition:transform .3s;margin-right:2px}
.wxz-fqd .item.open .ar{transform:rotate(-135deg);border-color:var(--c)}
.wxz-fqd .a{display:grid;grid-template-rows:0fr;transition:grid-template-rows .32s ease}
.wxz-fqd .item.open .a{grid-template-rows:1fr}
.wxz-fqd .a > div{overflow:hidden}
.wxz-fqd .a p{margin:0;padding:0 13px 13px;font-size:13px;color:#a0aec0;line-height:1.75} /* 7.23 ✓ */
@media (prefers-reduced-motion:reduce){
.wxz-fqd .item,.wxz-fqd .ar,.wxz-fqd .a{transition:none}
}
</style>
<div class="wxz-fqd" id="fqd1">
<div class="item open">
<button type="button" class="q" aria-expanded="true" aria-controls="fqd1a1">
如何订阅更新?<span class="ar" aria-hidden="true"></span></button>
<div class="a" id="fqd1a1" role="region"><div><p>在侧边栏输入邮箱,每周三会收到一封摘要邮件,随时可退订。</p></div></div>
</div>
<div class="item">
<button type="button" class="q" aria-expanded="false" aria-controls="fqd1a2">
支持哪些代码高亮?<span class="ar" aria-hidden="true"></span></button>
<div class="a" id="fqd1a2" role="region"><div><p>支持 HTML、CSS、JavaScript、PHP、Python 等常见语言,自动识别语言类型。</p></div></div>
</div>
<div class="item">
<button type="button" class="q" aria-expanded="false" aria-controls="fqd1a3">
可以转载文章吗?<span class="ar" aria-hidden="true"></span></button>
<div class="a" id="fqd1a3" role="region"><div><p>可以,采用 CC BY-NC-SA 4.0 协议,署名并注明出处即可。</p></div></div>
</div>
</div>
<script>
(function () {
var root = document.getElementById('fqd1');
if (!root) return;
var items = root.querySelectorAll('.item');
items.forEach(function (item) {
var btn = item.querySelector('.q');
btn.addEventListener('click', function () {
var willOpen = !item.classList.contains('open');
items.forEach(function (x) {
x.classList.remove('open');
x.querySelector('.q').setAttribute('aria-expanded', 'false');
});
if (willOpen) { item.classList.add('open'); btn.setAttribute('aria-expanded', 'true'); }
});
});
})();
</script>深色款:深灰卡片 + 亮色字,对比度 7.2~11.0 全部达标,展开态用蓝色底配亮蓝标题。同样用 button 与完整 ARIA。
改的时候注意这几点
- 用
<button:<button>天生可 Tab 聚焦、回车和空格都能触发,这些<div>全都没有。cursor:pointer` 只改光标外观,跟键盘可用性无关。 - 加
aria-ex:读屏才知道当前是展开还是收起。配合 aria-controls` 指向答案区,把两者关联。 - 能用
<detai:原生元素的键盘和读屏支持是开箱即有的,实测 tabindex就是 0、回车能展开,而自己写的<div>` 版全是"否"。 - 内联
<scrip:跟内联 onclick一样,写在 HTML 里的脚本在script-src 'self'策略下完全不执行。建议把 JS 单独存成.js` 文件在页脚引入——既避开 CSP,又能被浏览器缓存。 - 展开态的文字对比度别:原版收起态 17.46 很健康,展开态却掉到 4.18。压深一档到
#3b5bdb就有 5.21。 - 字号别低于 12px:原版答案只有 10px,中文基本糊了。
- 别用
max-he:得猜一个固定值,内容超了会被截断。用 grid-template-rows: 0fr → 1fr` 能自适应内容高度。 - 箭头图标标 `ari:它是纯装饰,读屏念出来是噪音。
transition写具体属性,别用transition:all。- 补 `prefers:把过渡动画关掉。
为什么类名都带 wxz- 前缀
CSS 是全局生效的,没有作用域概念。只要把 <style> 加进页面,里面的规则就会作用于整个站点,而不只是你粘贴的那一块。
这个组件用的类名(.wxz-fq 及其子元素)都是很常见的短名字,主题或插件里极可能已经有同名的类。一旦撞名,后加载的 CSS 会覆盖先加载的,站上别的地方就莫名其妙变了。我实测过一组对照——把没加前缀的 CSS 注入一个已有同类名的站点:
| 站点原本的样式 | 被改成 |
|---|---|
.title 40px |
13px |
.meta 红色 |
#64748b |
.item 无边框、红底 |
多了边框、变白底 |
加上 wxz- 前缀后再测,污染为 0。
所以:
- 照抄时保留
wxz-前缀,别图省事改回短名字。 - 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效。
- 如果你的主题里恰好也有
wxz-开头的类(极少见),换成你自己的前缀即可。 - 另外提醒:放进「外观 → 自定义 → 额外 CSS」的样式是全站加载的。只想在单篇文章用的话,把
<style>直接写在那篇文章里更合适。
怎么用
CSS 放进「外观 → 自定义 → 额外 CSS」;HTML 结构写在文章或小工具的「自定义 HTML」区块。
JS 单独存文件更好。在子主题目录下建一个 faq.js,内容就是修复版那段脚本,然后在 functions.php 里引入:
```php
function wxz_faq_script() {
if ( is_singular() ) { // 只在文章页加载,别全站都引
wp_enqueue_script(
'wxz-faq',
get_stylesheet_directory_uri() . '/faq.js',
array(),
'1.0',
true // true = 放页脚,不阻塞渲染
);
}
}
add_action( 'wp_enqueue_scripts', 'wxz_faq_script' );
```
用 wp_enqueue_script 而不是手写 <script> 标签,好处是能控制加载位置、自动带版本号、也不会重复加载。最后一个参数 true 表示放页脚。
注意脚本里用了 getElementById,一个页面放多个折叠面板时 ID 要唯一,或者改成用 class 遍历(跟前面横向滑动卡片那篇一样的思路)。
兼容性
<details> / <summary> 全系支持(含微信内置浏览器)。grid-template-rows 的 fr 过渡需要 Chrome 107+ / Firefox 66+ / Safari 16+,老浏览器上退化为瞬间展开(功能不受影响,只是没有动画)。:focus-visible 需要 Chrome 86+ / Firefox 85+ / Safari 15.4+。list-style:none 配合 ::-webkit-details-marker 隐藏默认三角,两条都要写才能覆盖全部浏览器。
代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。
作者:Flechazo
如若转载,请注明出处:维形筑网 https://wxzcw.com