按月分组的归档列表:一份能点、能读、能过 AA 的 CSS 归档卡片

侧栏放链接,一股脑列十几条会显得很散。按类目分组——每组一个小标题,下面挂几条链接,一眼就能看出结构。常见的用法有文章归档、友情链接分组、分类导航,也可以做成滚动条美化、备案美化这类同主题文章的汇总入口。

你给的这段只有骨架,HTML 里全是空标签,CSS 倒是写满了。我先按 CSS 里的类名补全了内容才看得出效果——补全后问题就全暴露了。下面每块都能点「预览效果」直接看。

原版 · 补全内容后的实际效果

HTML分组链接列表 · 原版(补全内容后)
<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:...} 会污染整站——粘进站点等于把整站边距、背景、字体全刷一遍。下面所有代码块都删掉了,照抄时不要加回去

修复版 · 真链接 + 语义结构

HTML分组链接列表 · 修复版
<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,没问题。

深色款 · 配暗色主题

HTML分组链接列表 · 深色款
<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分组链接列表 · 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

赞 (0)
折叠面板 FAQ:点击展开答案的手风琴效果
上一篇 2026年10月30日 上午12:39
公告滚动卡片:垂直轮播的站点公告
下一篇 2026年10月30日 下午1:23
维 形 筑 网