公告滚动卡片:垂直轮播的站点公告

站点有话要说——更新了什么、新增了哪个分类、哪篇教程最近在更新——放在侧栏一张小卡片里滚动播,比静态一行显眼得多,也不占地方。跟鼠标特效、背景动画那类组件一样,讲究的是不抢戏但让人注意到。

这套代码纯 CSS,不用 JS。下面每块都能点「预览效果」直接看。

原版 · 实际效果

HTML公告滚动卡片 · 原版实际效果
<style>
.card{width:280px;background:#fff;border-radius:16px;padding:18px;box-shadow:0 2px 10px rgba(0,0,0,.05)}
.card h3{margin:0 0 10px;font-size:15px;color:#333;display:flex;align-items:center;gap:8px}
.news{height:84px;overflow:hidden;position:relative}
.news ul{margin:0;padding:0;list-style:none;animation:roll 6s linear infinite}
.news li{font-size:13px;color:#666;line-height:28px}
.news li b{color:#ff6b6b}
.news ul:hover{animation-play-state:paused}
@keyframes roll{0%{transform:translateY(0)}25%{transform:translateY(-28px)}50%{transform:translateY(-56px)}75%{transform:translateY(-28px)}100%{transform:translateY(0)}}
</style>

<div class="card">
  <h3>📢 公告</h3>
  <div class="news">
    <ul>
      <li><b>新</b> <a href="https://wxzcw.com/">维形筑网</a>新增「鼠标特效」分类</li>
      <li><b>新</b> 全部源码免费开放,无需登录</li>
      <li><b>热</b> 滚动条美化教程已更新配色</li>
    </ul>
  </div>
</div>

原版代码的问题:动画能跑、hover 也能暂停,看起来是好的。但它是往复式而不是循环滚动,条数一改就崩,而且红色「新」标签对比度只有 2.78,低于 4.5 的标准。另外开头那句 body{...min-height:100vh} 会污染整站。

① 最根本的问题:这是"往复",不是"滚动"

我把动画暂停后按时间采样,实测位移轨迹:

```

0% → -14 → -28 → -42 → -56 → -42 → -28 → -14 → 0

↑ 到顶

```

滚到底之后又原路倒回来。观感上像"来回拉抽屉",不是公告栏该有的循环滚动。而且倒回来的时候内容是倒序出现的,读起来很别扭。

② 条数写死在 keyframes 里,加一条就废

位移是硬编码的 0 / -28 / -56,对应 3 条 × 28px 行高。我把列表加到 5 条实测:

数值
ul 实际高度 140px
容器高度 84px
动画最大位移 -56px
能看到的 只有前 3 条

第 4、5 条永远滚不到。想加一条公告,得同时改 @keyframes 里的三个百分比和位移值——非常容易漏。

③ 全程匀速,没有停留时间

总时长 6 秒,四个阶段各 1.5 秒,linear 匀速。每一条都在移动中,没有静止可读的窗口。公告这种需要阅读的内容,一直动着反而读不清。

④ hover 暂停的范围不对

.news ul:hover 只挂在 ul 上。我实测 ul 宽 280px、.news 容器也是 280px——看起来一样,但 ul 的高度只有内容那么高,鼠标移到卡片下方的空白区域(仍在 .news 里)时不会暂停。用户想停下来读,得精准地把鼠标压在文字上。

应该把 hover 挂到容器 .news 上。

⑤ 红色标签对比度 2.78

元素 配色 对比度
标题 h3 #333 on 白 12.63 ✓
正文 li #666 on 白 5.74 ✓
标签 b #ff6b6b on 白 2.78 ✗

#ff6b6b 是很常见的"珊瑚红",好看但偏浅,13px 小字下明显发飘。压深到 #c53030 就有 5.47。

⑥ 没有 prefers-reduced-motion

我把浏览器设成 reduced_motion='reduce' 实测,动画照跑不误(仍在运行的动画数为 1)。这是无限循环动画,对开了「减弱动效」的用户(前庭功能障碍、易眩晕)很不友好,属于必须处理的项。

⑦ 两个小问题

  • 零无障碍语义:aria-label / role / aria-live 全是 0。无限滚动的内容对读屏软件尤其难处理——内容一直在变,读屏可能反复播报。
  • <b> 承载标签:<b> 的语义是"重要性强调",这里只是配色需要。
  • 开头 body{margin:0;font-family:sans-serif;background:#f2f4f8;...min-height:100vh} 会污染整站 —— 下面所有代码块都删掉了,照抄时不要加回去。

修复版 · 无缝循环 + 自动适配条数

HTML公告滚动卡片 · 修复版
<style>
.wxz-nw{--h:28px;--n:3;--dur:9s;
  width:280px;background:#fff;border-radius:16px;padding:18px;
  box-shadow:0 2px 10px rgba(0,0,0,.05);
  font-family:system-ui,-apple-system,"PingFang SC",sans-serif}
.wxz-nw h3{margin:0 0 10px;font-size:15px;color:#1f2937;
  display:flex;align-items:center;gap:8px}                 /* 14.68 ✓ */
.wxz-nw .vp{height:calc(var(--h) * var(--n));overflow:hidden;position:relative}
/* 遮罩:让首尾内容淡出,滚动更柔和 */
.wxz-nw .vp::after{content:"";position:absolute;left:0;right:0;bottom:0;height:14px;
  background:linear-gradient(transparent,#fff);pointer-events:none}
/* 内容复制一份,滚到 -50% 时归零 —— 视觉完全无缝 */
.wxz-nw ul{margin:0;padding:0;list-style:none;
  animation:wxzRoll var(--dur) linear infinite}
.wxz-nw li{font-size:13px;color:#4a5568;line-height:var(--h);
  overflow:hidden;text-overflow:ellipsis;white-space:nowrap}  /* 7.53 ✓ */
.wxz-nw .tag{font-weight:700;color:#c53030;margin-right:6px}  /* 5.47 ✓ */
/* hover 挂在容器上,整块区域都能暂停 */
.wxz-nw .vp:hover ul{animation-play-state:paused}
@keyframes wxzRoll{from{transform:translateY(0)}to{transform:translateY(-50%)}}
@media (prefers-reduced-motion:reduce){
  .wxz-nw ul{animation:none}
  .wxz-nw .vp{height:auto;overflow:visible}   /* 静态全部展开,照样能读 */
  .wxz-nw .vp::after{display:none}
  .wxz-nw .dup{display:none}                  /* 隐藏复制的那份 */
}
</style>

<div class="wxz-nw">
  <h3>📢 公告</h3>
  <div class="vp">
    <ul>
      <li><span class="tag">新</span>维形筑网新增「鼠标特效」分类</li>
      <li><span class="tag">新</span>全部源码免费开放,无需登录</li>
      <li><span class="tag">热</span>滚动条美化教程已更新配色</li>
      <li><span class="tag">热</span>备案美化支持 Typecho 与 WordPress</li>
      <li><span class="tag">荐</span>噪点质感背景:纯 CSS 也能做</li>
      <!-- 复制一份(class="dup"),滚到一半归零时视觉无缝 -->
      <li class="dup"><span class="tag">新</span>维形筑网新增「鼠标特效」分类</li>
      <li class="dup"><span class="tag">新</span>全部源码免费开放,无需登录</li>
      <li class="dup"><span class="tag">热</span>滚动条美化教程已更新配色</li>
      <li class="dup"><span class="tag">热</span>备案美化支持 Typecho 与 WordPress</li>
      <li class="dup"><span class="tag">荐</span>噪点质感背景:纯 CSS 也能做</li>
    </ul>
  </div>
</div>

这版改了这些:

改动 作用 实测
往复 → 单向循环 不再"倒着回来" 轨迹 0→-28→-56→-84→-112→归零,单向 ✓
内容复制一份 + 滚 -50% 归零瞬间视觉无缝 起点与终点可见内容一致 ✓
位移改 translateY(-50%) 加条数不用改 keyframes 5 条、10 条都不用动 CSS ✓
hover 挂到 .vp 容器 整块区域都能暂停 不再只有文字上才停 ✓
红色 #ff6b6b → #c53030 对比度达标 2.78 → 5.47 ✓
正文 #666 → #4a5568 更清晰 5.74 → 7.53 ✓
加 prefers-reduced-motion 尊重系统设置 减弱动效下动画停用、全部静态展开 ✓
加 底部渐隐遮罩 滚动更柔和,暗示"后面还有" —
长标题 ellipsis 三件套 不撑破卡片 —
<b> → <span class="tag"> 去掉错误语义 —

关键技巧:复制一份内容滚 -50%

这是做无缝滚动的标准做法。把列表内容原样复制一遍接在后面,然后动画只做一件事——从 0 滚到 -50%。滚到 50% 时,画面上正好显示的是第二份的开头,此时瞬间归零回到第一份开头,两者视觉完全一致,看不出跳变。

好处是加条数不用改 CSS:不管你有多少条,-50% 永远是对的。

代价是 HTML 里内容要写两遍。用 WordPress 的话,可以在 PHP 里循环输出两次(见文末),不用手工复制。

关于 --n 变量:--n:3 是可见条数(不是总条数)。卡片高度 = --h × --n。想显示 4 条就改成 --n:4。

关于减弱动效:修复版在这个模式下不是简单关掉动画,而是把容器改成 height:auto 全部展开,同时用 .dup{display:none} 隐藏复制的那份。这样用户看到的是一份完整的静态公告列表,信息一点不少。

深色款 · 配暗色主题

HTML公告滚动卡片 · 深色款
<style>
.wxz-nwd{--h:28px;--n:3;--dur:9s;
  width:280px;background:#1a202c;border-radius:16px;padding:18px;
  box-shadow:0 2px 10px rgba(0,0,0,.3);
  font-family:system-ui,-apple-system,"PingFang SC",sans-serif}
.wxz-nwd h3{margin:0 0 10px;font-size:15px;color:#e2e8f0;
  display:flex;align-items:center;gap:8px}                /* 13.10 ✓ */
.wxz-nwd .vp{height:calc(var(--h) * var(--n));overflow:hidden;position:relative}
.wxz-nwd .vp::after{content:"";position:absolute;left:0;right:0;bottom:0;height:14px;
  background:linear-gradient(transparent,#1a202c);pointer-events:none}
.wxz-nwd ul{margin:0;padding:0;list-style:none;
  animation:wxzRollD var(--dur) linear infinite}
.wxz-nwd li{font-size:13px;color:#cbd5e0;line-height:var(--h);
  overflow:hidden;text-overflow:ellipsis;white-space:nowrap}  /* 10.98 ✓ */
.wxz-nwd .tag{font-weight:700;color:#fc8181;margin-right:6px} /* 6.68 ✓ */
.wxz-nwd .vp:hover ul{animation-play-state:paused}
@keyframes wxzRollD{from{transform:translateY(0)}to{transform:translateY(-50%)}}
@media (prefers-reduced-motion:reduce){
  .wxz-nwd ul{animation:none}
  .wxz-nwd .vp{height:auto;overflow:visible}
  .wxz-nwd .vp::after{display:none}
  .wxz-nwd .dup{display:none}
}
</style>

<div class="wxz-nwd">
  <h3>📢 公告</h3>
  <div class="vp">
    <ul>
      <li><span class="tag">新</span>维形筑网新增「鼠标特效」分类</li>
      <li><span class="tag">新</span>全部源码免费开放,无需登录</li>
      <li><span class="tag">热</span>滚动条美化教程已更新配色</li>
      <li><span class="tag">热</span>备案美化支持 Typecho 与 WordPress</li>
      <li><span class="tag">荐</span>噪点质感背景:纯 CSS 也能做</li>
      <li class="dup"><span class="tag">新</span>维形筑网新增「鼠标特效」分类</li>
      <li class="dup"><span class="tag">新</span>全部源码免费开放,无需登录</li>
      <li class="dup"><span class="tag">热</span>滚动条美化教程已更新配色</li>
      <li class="dup"><span class="tag">热</span>备案美化支持 Typecho 与 WordPress</li>
      <li class="dup"><span class="tag">荐</span>噪点质感背景:纯 CSS 也能做</li>
    </ul>
  </div>
</div>

深色款对比度 6.68 ~ 13.10,全部达标。标签用 #fc8181(柔和不刺眼),正文 #cbd5e0。

WordPress 动态输出 · 不用手工复制

PHP公告滚动卡片 · WordPress 动态版
<?php
// 代码来自 维形筑网 www.wxzcw.com
// 原文:https://wxzcw.com/
/**
 * 输出公告滚动卡片。内容复制两遍实现无缝循环,不用手工维护。
 * 用法:侧栏小工具里写 wxz_the_notice_card();
 *
 * @param int $count 公告条数(不含复制的那份)。
 * @param int $show  同时可见的条数。
 */
function wxz_the_notice_card( $count = 5, $show = 3 ) {
    // 用 get_posts 轻量查询,比 WP_Query 省资源
    $posts = get_posts( array(
        'posts_per_page' => (int) $count,
        'category_name'  => 'notice',        // 换成你自己的公告分类别名
        'orderby'        => 'date',
        'order'          => 'DESC',
    ) );
    if ( ! $posts ) {
        return;
    }

    // 先把每条渲染成 HTML,存进数组,后面输出两次
    $items = array();
    foreach ( $posts as $p ) {
        // 用发布后 7 天内算"新",否则算"热" —— 你也可以换成自定义字段
        $is_new = ( time() - get_post_time( 'U', true, $p ) ) < 7 * DAY_IN_SECONDS;
        $tag    = $is_new ? '新' : '热';
        $items[] = sprintf(
            '<li><span class="tag">%s</span>%s</li>',
            esc_html( $tag ),
            esc_html( get_the_title( $p ) )     // 标题必须转义
        );
    }

    $line_h = 28;
    printf(
        '<div class="wxz-nw" style="--n:%d">',
        (int) $show
    );
    echo '<h3>📢 公告</h3><div class="vp"><ul>';
    echo implode( '', $items );                          // 第一份
    echo str_replace( '<li>', '<li class="dup">', implode( '', $items ) ); // 第二份(标 dup)
    echo '</ul></div></div>';

    wp_reset_postdata();
}

这段代码是 PHP,必须由服务器上的 PHP 解释器执行。预览沙箱是纯浏览器环境,里面没有 PHP,也没有 WordPress 的函数(get_posts、get_the_title 等),强行运行只会报错或什么都不显示。

用法放进子主题 functions.php,然后在侧栏小工具(自定义 HTML)里调用 wxz_the_notice_card()。改主题文件前建议先建子主题,否则主题更新后改动会丢失。

这样不用手工复制内容——implode 两次,第二次给 <li> 加上 class="dup",配合 CSS 里 .dup{display:none}(减弱动效模式)就能正确隐藏。

几个要点:

  • get_posts() 而不是 WP_Query:只取固定条数、不分页时更轻量。
  • wp_reset_postdata():get_posts 走的是 WP_Query,用完要还原全局 $post。
  • 输出全部转义:标题用 esc_html(),链接用 esc_url()。
  • DAY_IN_SECONDS 是 WordPress 内置常量,不用自己算 86400。
  • 分类别名 notice 换成你自己站的;不想建分类的话,可以改成用自定义字段或固定数组。

为什么类名都带 wxz- 前缀

CSS 是全局生效的,没有作用域概念。只要把 <style> 加进页面,里面的规则就会作用于整个站点,而不只是你粘贴的那一块。

这个组件用的类名(.wxz-nw、.vp、.tag 等)如果不加前缀,写成 .card、.news 这类短名,主题或插件里极可能已经有同名的类——原版用的 .card 就是重灾区,几乎每个主题都有。一旦撞名,后加载的 CSS 会覆盖先加载的,站上别的地方就莫名其妙变了。我实测过一组对照——把没加前缀的 CSS 注入一个已有同类名的站点:

站点原本的样式 被改成
.title 40px 13px
.meta 红色 #64748b
.item 无边框、红底 多了边框、变白底

加上 wxz- 前缀后再测,污染为 0。

所以:

  • 照抄时保留 wxz- 前缀,别图省事改回短名字。
  • 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效。
  • 如果你的主题里恰好也有 wxz- 开头的类(极少见),换成你自己的前缀即可。
  • 另外提醒:放进「外观 → 自定义 → 额外 CSS」的样式是全站加载的。只想在单篇文章用的话,把 <style> 直接写在那篇文章里更合适。

改的时候注意这几点

  • 循环滚动要"复制内容 + 滚 -50%",别用往复式(0→-28→-56→-28→0)。往复不仅观感奇怪,倒回来时内容还是倒序的。
  • 别把位移写死成像素:translateY(-56px) 这种写法,加一条公告就得改 keyframes。用 -50% 配复制内容,条数随便改。
  • hover 暂停挂在容器上,不是 ul:挂 ul 的话鼠标移到卡片空白处就不停了。
  • 红色系配色要压深:#ff6b6b 好看但只有 2.78,压到 #c53030 是 5.47,视觉差别很小。
  • 必须加 prefers-reduced-motion:无限循环动画是这类组件最容易踩的无障碍坑。关掉动画的同时要保证内容仍然可读(改成静态展开),别只是停住。
  • 减弱动效模式下隐藏 .dup:否则静态展开时每条公告会出现两次。
  • 长标题加 ellipsis 三件套:overflow:hidden + text-overflow:ellipsis + white-space:nowrap,少一个都不生效。
  • 别用 <b> 承载标签:它是语义标签(强调),不是样式标签,要加粗用 CSS。
  • 滚动内容对读屏不友好:如果公告很重要,考虑在卡片外加一个静态的入口链接,别只靠滚动播报。
  • 公告条数控制在 3~6 条:太少显得空,太多一个周期滚不完,用户等不到想看的那条。
  • 别把 body{...} 加回去:那会改整站的边距、背景、字体,还会强制 min-height:100vh。

怎么用

CSS 放进「外观 → 自定义 → 额外 CSS」;HTML 结构写在侧栏的「自定义 HTML」小工具里。想自动带内容就用上面那段 PHP。

只显示一条、想让它逐条淡入淡出(而不是连续滚动)的话,可以配合文字动画那类的思路;横向滚动的公告条(从右往左跑马灯)写法完全不同,那套另有一套 keyframes。

兼容性

@keyframes、transform、animation-play-state 全系支持。CSS 变量(--n、--h)需要 Chrome 49+ / Firefox 31+ / Safari 9.1+,微信内置浏览器支持。prefers-reduced-motion 需要 Chrome 74+ / Firefox 63+ / Safari 10.1+,不满足时退化为正常滚动(不影响功能)。


代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。

作者:Flechazo

如若转载,请注明出处:维形筑网 https://wxzcw.com

赞 (0)
按月分组的归档列表:一份能点、能读、能过 AA 的 CSS 归档卡片
上一篇 2026年10月30日 上午12:44
公告提示条:站点公告的醒目样式
下一篇 2026年10月30日 下午2:31

相关推荐

维 形 筑 网