站点有话要说——更新了什么、新增了哪个分类、哪篇教程最近在更新——放在侧栏一张小卡片里滚动播,比静态一行显眼得多,也不占地方。跟鼠标特效、背景动画那类组件一样,讲究的是不抢戏但让人注意到。
这套代码纯 CSS,不用 JS。下面每块都能点「预览效果」直接看。
原版 · 实际效果
<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}会污染整站 —— 下面所有代码块都删掉了,照抄时不要加回去。
修复版 · 无缝循环 + 自动适配条数
<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} 隐藏复制的那份。这样用户看到的是一份完整的静态公告列表,信息一点不少。
深色款 · 配暗色主题
<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
// 代码来自 维形筑网 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