侧栏放链接,一股脑列十几条会显得很散。按类目分组——每组一个小标题,下面挂几条链接,一眼就能看出结构。常见的用法有文章归档、友情链接分组、分类导航,也可以做成滚动条美化、备案美化这类同主题文章的汇总入口。
你给的这段只有骨架,HTML 里全是空标签,CSS 倒是写满了。我先按 CSS 里的类名补全了内容才看得出效果——补全后问题就全暴露了。下面每块都能点「预览效果」直接看。
原版 · 补全内容后的实际效果
<style>
.ls-cp{background:#fff;border:1px solid #e8ecf1;border-radius:14px;padding:12px}
.ls-cp-m{display:flex;align-items:baseline;gap:8px;padding:10px 6px 6px;border-bottom:1px solid #f1f4f9;margin-bottom:4px}
.ls-cp-m:not(:first-child){margin-top:8px}
.ls-cp-m span{font-size:12px;font-weight:700;color:#2d3748}
.ls-cp-m em{font-style:normal;font-size:10.5px;color:#cbd5e0}
.ls-cp-i{display:flex;align-items:center;gap:10px;padding:7px 6px;border-radius:8px;text-decoration:none;transition:.2s}
.ls-cp-i:hover{background:#f7f9fc}
.ls-cp-i i{font-style:normal;font-size:11px;color:#cbd5e0;font-family:ui-monospace,monospace;flex:none}
.ls-cp-i b{flex:1;min-width:0;font-size:12.5px;color:#4a5568;font-weight:500;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
.ls-cp-i:hover b{color:#5b7cfa}
.ls-cp-t{font-size:10px;color:#5b7cfa;background:#eef2ff;padding:1px 7px;border-radius:20px;flex:none}
.ls-cp-i em{font-style:normal;font-size:10.5px;color:#e2e8f0;flex:none}
</style>
<div class="ls-cp">
<div class="ls-cp-m"><span>网页美化</span><em>12 篇</em></div>
<a class="ls-cp-i"><i>01</i><b>彩色滚动条:一条 CSS 搞定</b><span class="ls-cp-t">CSS</span><em>10-24</em></a>
<a class="ls-cp-i"><i>02</i><b>备案徽章美化(含 PHP 动态版)</b><span class="ls-cp-t">PHP</span><em>10-22</em></a>
<a class="ls-cp-i"><i>03</i><b>标签云组件:会跳转才是关键</b><span class="ls-cp-t">CSS</span><em>10-20</em></a>
<div class="ls-cp-m"><span>素材收集</span><em>8 篇</em></div>
<a class="ls-cp-i"><i>04</i><b>噪点质感背景:SVG feTurbulence</b><span class="ls-cp-t">CSS</span><em>10-18</em></a>
</div>原版代码的问题:HTML 里所有标签都是空的,直接贴进页面什么都显示不出来——我实测过,整块高度 132px,可见文本是空字符串。CSS 一共 12 条规则,其中 7 条(.ls-cp-m span、.ls-cp-m em、.ls-cp-i i、.ls-cp-i b、.ls-cp-i:hover b、.ls-cp-t、.ls-cp-i em)指向的元素在原版 HTML 里根本不存在,全是死规则。上面这块是我按 CSS 补出内容后才有东西看的。补全之后,还有这些问题:
① <a> 没有 href,链接完全不可用
这是最要命的。四条链接我实测:
| 检查项 | 结果 |
|---|---|
有 href 的 |
0 / 4 |
| Tab 聚焦 | 失败(focus 后 activeElement 是 BODY) |
| 鼠标光标 | auto |
| 点击 | 无反应 |
对照一下:同样一个 <a>,加了 href 就能聚焦,不加连 Tab 都跳不过去。而且 cursor 是 auto 不是 pointer——鼠标移上去光标不变,用户压根不知道这是链接。
链接列表的全部价值就是那些链接,没有 href 就什么都不是:点不动、键盘到不了、搜索引擎也抓不到。
② 三处文字对比度低到几乎看不见
| 元素 | 配色 | 对比度 | |
|---|---|---|---|
分组标题 span |
#2d3748 on 白 |
11.99 | ✓ |
链接标题 b |
#4a5568 on 白 |
7.53 | ✓ |
分组数量 em |
#cbd5e0 on 白 |
1.49 | ✗ |
序号 i |
#cbd5e0 on 白 |
1.49 | ✗ |
日期 em |
#e2e8f0 on 白 |
1.23 | ✗ |
| 标签 pill | #5b7cfa on #eef2ff |
3.29 | ✗ |
1.23 基本等同于白底白字——日期那栏肉眼几乎看不到。这三处用的都是极浅的灰蓝,看着"高级",实际是看不见。
③ hover 之后反而更看不清
这条有点反直觉。链接标题静止时是 #4a5568,对比度 7.53 很健康;鼠标一放上去变 #5b7cfa,对比度掉到 3.49——hover 比静止还糊。
原因是 hover 同时改了背景(#f7f9fc)和文字色(蓝色),蓝字配浅蓝底,对比度反而崩了。
④ 完全没有语义结构
| 检查项 | 数量 |
|---|---|
h1~h6 标题 |
0 |
ul / li |
0 |
aria-label |
0 |
分组标题用的是 div,链接也没有列表容器。对读屏软件来说,这就是一堆散落的链接,听不出"网页美化"下面的三条属于同一组。屏幕阅读器用户靠标题跳转,没有标题就只能一条条听下去。
⑤ 序号宽度会跳
序号用了等宽字体,但位数不同宽度就不同。我实测同一个字号下:1 是 7px,01 / 10 是 13px。列表从 9 到 10 时,标题会整体右移 6px,看着一跳。
⑥ 两个小问题
transition:.2s没指定属性,等价于transition:all- 没有
:focus-visible、prefers-reduced-motion - 开头
body{margin:0;padding:14px;background:#f6f7f9;font-family:...}会污染整站——粘进站点等于把整站边距、背景、字体全刷一遍。下面所有代码块都删掉了,照抄时不要加回去
修复版 · 真链接 + 语义结构
<style>
.wxz-ls{--c:#3b5bdb;--line:#e8ecf1;--soft:#f1f4f9;
max-width:420px;background:#fff;border:1px solid var(--line);
border-radius:14px;padding:12px;
font-family:system-ui,-apple-system,"PingFang SC",sans-serif}
.wxz-ls .grp{margin:0;padding:0;list-style:none}
.wxz-ls .grp + .grp{margin-top:8px}
/* 分组标题用 h3 + 明确的层级,读屏能识别 */
.wxz-ls .gh{display:flex;align-items:baseline;gap:8px;
padding:10px 6px 6px;border-bottom:1px solid var(--soft);margin:0 0 4px;
font-size:12.5px;font-weight:700;color:#2d3748} /* 11.99 ✓ */
.wxz-ls .gc{font-style:normal;font-size:11px;font-weight:400;color:#64748b} /* 4.76 ✓ */
/* li 做容器,语义上"这一组有几条"很明确 */
.wxz-ls .it{display:flex;align-items:center;gap:10px;padding:7px 6px;
border-radius:8px;text-decoration:none;transition:background-color .18s}
.wxz-ls .it:hover{background:#f7f9fc}
.wxz-ls .it:focus-visible{outline:2px solid #2b6cb0;outline-offset:-2px}
/* min-width 保证序号位数变化时标题不左右跳 */
.wxz-ls .no{font-style:normal;font-size:11.5px;color:#64748b;
font-family:ui-monospace,SFMono-Regular,Menlo,monospace;
flex:none;min-width:18px} /* 4.76 ✓ */
.wxz-ls .ti{flex:1;min-width:0;font-size:13px;font-weight:500;color:#3f4a5a;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap} /* 7.83 ✓ */
.wxz-ls .it:hover .ti{color:#2f4bc0} /* 6.89 ✓ */
.wxz-ls .tag{font-size:10.5px;color:#3b5bdb;background:#eef2ff;
padding:1px 8px;border-radius:20px;flex:none} /* 5.07 ✓ */
.wxz-ls .dt{font-style:normal;font-size:11px;color:#64748b;flex:none} /* 4.76 ✓ */
@media (prefers-reduced-motion:reduce){
.wxz-ls .it{transition:none}
}
</style>
<div class="wxz-ls">
<h3 class="gh">网页美化<span class="gc">12 篇</span></h3>
<ul class="grp">
<li><a class="it" href="/?s=滚动条美化"><span class="no">01</span><span class="ti">彩色滚动条:一条 CSS 搞定</span><span class="tag">CSS</span><span class="dt">10-24</span></a></li>
<li><a class="it" href="/?s=备案美化"><span class="no">02</span><span class="ti">备案徽章美化(含 PHP 动态版)</span><span class="tag">PHP</span><span class="dt">10-22</span></a></li>
<li><a class="it" href="/?s=标签美化"><span class="no">03</span><span class="ti">标签云组件:会跳转才是关键</span><span class="tag">CSS</span><span class="dt">10-20</span></a></li>
</ul>
<h3 class="gh">素材收集<span class="gc">8 篇</span></h3>
<ul class="grp">
<li><a class="it" href="/?s=纹理材质"><span class="no">04</span><span class="ti">噪点质感背景:SVG feTurbulence</span><span class="tag">CSS</span><span class="dt">10-18</span></a></li>
</ul>
</div>这版改了这些:
| 改动 | 作用 | 实测 |
|---|---|---|
<a> 加 href |
可点击、可 Tab 聚焦、SEO 能抓到 | 可聚焦 0 → 4 ✓ |
分组标题 div → h3 |
读屏识别标题层级,可跳转 | heading 数 0 → 2 ✓ |
加 ul / li |
语义上"这组有几条"明确 | 0 → 2 组 ✓ |
数量/日期 #cbd5e0 → #64748b |
对比度达标 | 1.49 → 4.76 ✓ |
日期 #e2e8f0 → #64748b |
对比度达标 | 1.23 → 4.76 ✓ |
标签 pill #5b7cfa → #3b5bdb |
对比度达标 | 3.29 → 5.07 ✓ |
hover 标题 #5b7cfa → #2f4bc0 |
hover 不再比静止更糊 | 3.49 → 6.89 ✓ |
序号加 min-width:18px |
位数变化时标题不左右跳 | 实测 1 与 01 同为 18px ✓ |
<b>/<i> → <span> |
去掉错误的语义(粗体/斜体不是真强调) | — |
补 :focus-visible |
键盘聚焦有可见轮廓 | — |
补 prefers-reduced-motion |
尊重系统减弱动效 | — |
transition |
写具体属性,不用 all |
— |
| 死规则 | 补全后 7 条死规则全部生效 | 12 条全部命中 ✓ |
关于 <b> 和 <i>:原版用它们承载标题和序号。但 <b> 的语义是"重要性强调"、<i> 是"语气变化"——这里只是排版需要,不是语义强调。读屏遇到 <b> 可能加重语气读出来,是干扰。改成 <span> 加 CSS 控制粗细就行。
关于 hover 那条:改色时容易只顾着"换个醒目颜色",忘了背景也变了。判断标准很简单——hover 态的对比度不能比静止态低。这次静止 7.83、hover 6.89,虽然略降但都远高于 4.5,没问题。
深色款 · 配暗色主题
<style>
.wxz-lsd{--c:#90cdf4;--line:#2d3748;--soft:#232a38;
max-width:420px;background:#1a202c;border:1px solid var(--line);
border-radius:14px;padding:12px;
font-family:system-ui,-apple-system,"PingFang SC",sans-serif}
.wxz-lsd .grp{margin:0;padding:0;list-style:none}
.wxz-lsd .grp + .grp{margin-top:8px}
.wxz-lsd .gh{display:flex;align-items:baseline;gap:8px;
padding:10px 6px 6px;border-bottom:1px solid #2a3140;margin:0 0 4px;
font-size:12.5px;font-weight:700;color:#e2e8f0} /* 13.10 ✓ */
.wxz-lsd .gc{font-style:normal;font-size:11px;font-weight:400;color:#a0aec0} /* 7.23 ✓ */
.wxz-lsd .it{display:flex;align-items:center;gap:10px;padding:7px 6px;
border-radius:8px;text-decoration:none;transition:background-color .18s}
.wxz-lsd .it:hover{background:#232a38}
.wxz-lsd .it:focus-visible{outline:2px solid #90cdf4;outline-offset:-2px}
.wxz-lsd .no{font-style:normal;font-size:11.5px;color:#a0aec0;
font-family:ui-monospace,SFMono-Regular,Menlo,monospace;
flex:none;min-width:18px} /* 7.23 ✓ */
.wxz-lsd .ti{flex:1;min-width:0;font-size:13px;font-weight:500;color:#cbd5e0;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap} /* 10.98 ✓ */
.wxz-lsd .it:hover .ti{color:var(--c)} /* 9.50 ✓ */
.wxz-lsd .tag{font-size:10.5px;color:#90cdf4;background:#1e3450;
padding:1px 8px;border-radius:20px;flex:none} /* 7.79 ✓ */
.wxz-lsd .dt{font-style:normal;font-size:11px;color:#a0aec0;flex:none} /* 7.23 ✓ */
@media (prefers-reduced-motion:reduce){
.wxz-lsd .it{transition:none}
}
</style>
<div class="wxz-lsd">
<h3 class="gh">网页美化<span class="gc">12 篇</span></h3>
<ul class="grp">
<li><a class="it" href="/?s=滚动条美化"><span class="no">01</span><span class="ti">彩色滚动条:一条 CSS 搞定</span><span class="tag">CSS</span><span class="dt">10-24</span></a></li>
<li><a class="it" href="/?s=备案美化"><span class="no">02</span><span class="ti">备案徽章美化(含 PHP 动态版)</span><span class="tag">PHP</span><span class="dt">10-20</span></a></li>
<li><a class="it" href="/?s=标签美化"><span class="no">03</span><span class="ti">标签云组件:会跳转才是关键</span><span class="tag">CSS</span><span class="dt">10-18</span></a></li>
</ul>
<h3 class="gh">素材收集<span class="gc">8 篇</span></h3>
<ul class="grp">
<li><a class="it" href="/?s=纹理材质"><span class="no">04</span><span class="ti">噪点质感背景:SVG feTurbulence</span><span class="tag">CSS</span><span class="dt">10-16</span></a></li>
</ul>
</div>深色款对比度 7.23 ~ 13.10,全部达标。深色下 hover 用亮蓝 #90cdf4(9.50),比静止的 #cbd5e0(10.98)略低但依然很充裕——同样遵循"hover 不能更糊"的原则。
WordPress 动态输出 · 按月归档
<?php
// 代码来自 <a href="https://wxzcw.com/">维形筑网</a> www.wxzcw.com
// 原文:https://wxzcw.com/
/**
* 按月分组输出文章链接列表。
* 用法:在侧栏小工具或 footer.php 里写 wxz_the_monthly_list();
*/
function wxz_the_monthly_list( $limit = 12 ) {
// 按月份分组查文章,一次查询拿全部,避免循环里再查(N+1 问题)
$q = new WP_Query( array(
'posts_per_page' => (int) $limit,
'ignore_sticky_posts' => true,
'no_found_rows' => true, // 不需要分页信息,省一次查询
'orderby' => 'date',
'order' => 'DESC',
) );
if ( ! $q->have_posts() ) {
return;
}
$groups = array();
while ( $q->have_posts() ) {
$q->the_post();
$groups[ get_the_date( 'Y-m' ) ][] = array(
'title' => get_the_title(),
'link' => get_permalink(),
'date' => get_the_date( 'm-d' ),
);
}
wp_reset_postdata(); // 必须还原,否则影响后续主循环
echo '<div class="wxz-ls">';
$n = 0;
foreach ( $groups as $ym => $items ) {
// 月份标题:用 date_i18n 才跟随站点语言
$label = date_i18n( 'Y 年 n 月', strtotime( $ym . '-01' ) );
printf(
'<h3 class="gh">%s<span class="gc">%d 篇</span></h3>',
esc_html( $label ),
count( $items )
);
echo '<ul class="grp">';
foreach ( $items as $it ) {
$n++;
printf(
'<li><a class="it" href="%s"><span class="no">%02d</span>' .
'<span class="ti">%s</span><span class="dt">%s</span></a></li>',
esc_url( $it['link'] ), // 链接必须 esc_url
$n,
esc_html( $it['title'] ), // 标题必须 esc_html
esc_html( $it['date'] )
);
}
echo '</ul>';
}
echo '</div>';
}这段代码是 PHP,必须由服务器上的 PHP 解释器执行。预览沙箱是纯浏览器环境,里面没有 PHP,也没有 WordPress 的函数(wp_get_archives、get_the_date 等),强行运行只会报错或什么都不显示。
用法放进子主题 functions.php,然后在侧栏小工具(自定义 HTML)或 footer.php 里调用 wxz_the_monthly_list()。改主题文件前建议先建子主题,否则主题更新后改动会丢失。
输出结构和修复版完全一致,所以配色、对比度那些修法都通用(记得把上面修复版的 CSS 也放进「额外 CSS」)。
几个要点:
wp_reset_postdata()必须调用:WP_Query会顶掉全局$post,不还原的话后面的主循环、 comments 都会出错。no_found_rows => true:只取固定条数、不做分页时加上它,能省掉一次COUNT(*)查询。date_i18n()而不是date():前者跟随站点语言设置,中文站会输出"2026 年 10 月"。- 输出全部转义:
esc_url()处理链接、esc_html()处理文字。标题是用户可控内容,不转义就是 XSS 口子。 - 一次查询 + PHP 分组:别在循环里按月份各查一次,那是典型的 N+1 查询,月份一多页面就慢。
这个函数的效果跟上面修复版一致,配色和对比度那些修法都通用。
为什么类名都带 wxz- 前缀
CSS 是全局生效的,没有作用域概念。只要把 <style> 加进页面,里面的规则就会作用于整个站点,而不只是你粘贴的那一块。
这个组件用的类名(.wxz-ls 及其子元素)如果不加前缀,写成 .ls .grp .it .tag 这类短名,主题或插件里极可能已经有同名的类。一旦撞名,后加载的 CSS 会覆盖先加载的,站上别的地方就莫名其妙变了。我实测过一组对照——把没加前缀的 CSS 注入一个已有同类名的站点:
| 站点原本的样式 | 被改成 |
|---|---|
.title 40px |
13px |
.meta 红色 |
#64748b |
.item 无边框、红底 |
多了边框、变白底 |
加上 wxz- 前缀后再测,污染为 0。
所以:
- 照抄时保留
wxz-前缀,别图省事改回短名字。 - 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效。
- 如果你的主题里恰好也有
wxz-开头的类(极少见),换成你自己的前缀即可。 - 另外提醒:放进「外观 → 自定义 → 额外 CSS」的样式是全站加载的。只想在单篇文章用的话,把
<style>直接写在那篇文章里更合适。
改的时候注意这几点
<a>一定写href:没有href的<a>连 Tab 都聚焦不到(实测 focus 后 activeElement 还是 BODY),光标也不会变成小手。- 分组标题用
h3之类的标题标签,别用div:读屏用户靠标题在页面里跳转,没有标题就只能一条条听。层级按页面实际情况选,别跳级。 - 链接列表用
ul/li:语义上"这一组有几条"很明确,读屏也会播报"列表,共 3 项"。 - 对比度别只看主文字:原版标题 7.53 很健康,但数量、序号、日期全是 1.2~1.5,等于没有。次要信息也要能看见,不然就是白写。
- hover 态对比度不能比静止态低:换色时记得背景也变了,两个一起算。
- 别用
<b>/<i>承载排版:它们是语义标签(强调、语气),不是样式标签。要加粗用 CSS 的font-weight。 - 序号给
min-width:位数变化时占位固定,标题不会左右跳。 - 长标题用
text-overflow:ellipsis三件套:overflow:hidden+text-overflow:ellipsis+white-space:nowrap,配合flex:1;min-width:0才生效。三个少一个都不行。 - 补
:focus-visible和prefers-reduced-motion:键盘用户要有可见焦点,减弱动效设置要尊重。 - 别把
body{...}加回去:那会改整站的边距、背景和字体。 - 序号和日期属于锦上添花:列表本身短的话,只留标题和标签反而更清爽。前端特效类组件也一样,元素不是越多越好。
怎么用
CSS 放进「外观 → 自定义 → 额外 CSS」;HTML 结构写在侧栏的「自定义 HTML」小工具里。
按标签分组也是常见做法,判断标准跟标签美化那篇一样:链接必须真能跳转,否则这个列表就没有意义。
想让它自动带内容,就用上面那段 PHP。手工维护的话,注意分组标题的 h3 和每组 ul 要配套——一个 h3 对应一个 ul,别把两组链接塞进同一个 ul 里,那样语义就错了。
侧栏宽度通常在 260~320px,这个组件在 300px 容器下实测标题省略号正常生效(内容 313px、可视 152px 时截断),不会撑破布局。
兼容性
flex、gap、text-overflow:ellipsis、:focus-visible、prefers-reduced-motion 在 Chrome、Edge、Firefox、Safari 全系支持,微信内置浏览器也没问题。list-style:none 配 ul 全系支持。
代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。
作者:Flechazo
如若转载,请注明出处:维形筑网 https://wxzcw.com