侧栏或页脚挂一条浅粉胶囊公告,每条公告配一个自己的圆形图标和底色,右边还能带「新品」「通知」这类小标签。滚轮滚一下、手指上下滑一下、点一下,都会换到下一条;不操作就自己轮播。这种组件用 overflow:hidden 加一条纵向 transform 就能做,不依赖任何库。
这份代码本身写得比大多数流传片段整齐:图标内置了 7 种、深浅色会跟着主题和系统走、还写了 prefers-reduced-motion。但实际用起来还是踩了一串坑,最硬的一条是 一页放两份就串台——第一份变成 8 条、第二份一片空白;另外 鼠标停在公告条上,整页都滚不动了。下面先放原版和逐条实测,再给一份自包含的修复版。本站的 公告栏、悬浮挂件 和 网站美化 栏目里还有不少这类小工具,写法可以对照着看。
原版 · 实际效果
<!--
上下滚动公告条 · 复刻截图(浅粉胶囊 + 玫红圆图标 + 红字)
特性:① 每条公告一个「标」:独立图标 + 独立底色 + 可选右侧标签
② 滚轮 / 触摸上下滑 / 点击 / 自动轮播,滚一下换一条
③ 图标可改:内置名 / emoji / 自定义 SVG / 图片 URL
④ 响应式 + 深浅色自适应 + 尊重「减少动态效果」
用法:整段复制到 WordPress 后台 → 外观 → 小工具 →「自定义 HTML」;也可直接双击本地预览
若站点过滤了脚本标签,把末尾脚本用 WPCode / Insert Headers and Footers 插到页脚即可
改公告:只动脚本最上面的 NOTICES 数组,其余不用碰
-->
<div id="nb-root" style="width:100%;max-width:760px;margin:0 auto;container-type:inline-size;container-name:nb;">
<div id="nb-wrap" class="nb-wrap" tabindex="0" role="region" aria-label="站点公告,滚动或点击查看下一条" title="滚轮 / 上下滑 / 点击 切换公告">
<div id="nb-view" class="nb-view">
<div id="nb-track" class="nb-track"></div>
</div>
</div>
</div>
<script>
(function () {
/* ============================================================
① 只改这里:一条一个对象 = 一个公告一个标
icon : 'file' | 'gift' | 'bell' | 'star' | 'info' | 'link' | 'warn'
· 也可直接写 emoji,如 '🎉'、'📢'
· 也可写整段 <svg>...</svg>
· 也可写图片地址,如 'https://wxzcw.com/wp-content/uploads/icon.png'
color : 该条图标圆形底色(不填用默认玫红)
fg : 该条文字颜色(不填用默认红)
text : 公告文字
tag : 右侧小标签,不需要就删掉这一项
============================================================ */
var NOTICES = [
{ icon: 'file', color: '#d81b60', text: '已恢复正常更新,欢迎获取资源 - 2026.10.23' },
{ icon: 'gift', color: '#7c4dff', text: '新增 3 款侧边栏小工具,欢迎自取', tag: '新品' },
{ icon: 'bell', color: '#f59e0b', text: '站点夜间维护:今晚 23:00 - 24:00', tag: '通知' },
{ icon: 'star', color: '#0ea5e9', text: '深色模式自适应版本已上线', tag: '更新' }
];
var AUTO_MS = 4500; /* 自动轮播间隔,改成 0 可关闭自动滚动 */
/* ---------- 内置图标(白色描边,自动跟随圆形底色) ---------- */
var S = 'fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"';
var ICONS = {
file: '<svg viewBox="0 0 24 24" ' + S + '><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><path d="M14 2v6h6"/><path d="M8 13h8M8 17h5"/></svg>',
gift: '<svg viewBox="0 0 24 24" ' + S + '><path d="M20 12v9H4v-9M2 7h20v5H2zM12 22V7"/><path d="M12 7H7.5a2.5 2.5 0 0 1 0-5C11 2 12 7 12 7zM12 7h4.5a2.5 2.5 0 0 0 0-5C13 2 12 7 12 7z"/></svg>',
bell: '<svg viewBox="0 0 24 24" ' + S + '><path d="M18 8a6 6 0 0 0-12 0c0 7-3 9-3 9h18s-3-2-3-9"/><path d="M13.7 21a2 2 0 0 1-3.4 0"/></svg>',
star: '<svg viewBox="0 0 24 24" ' + S + '><path d="m12 2 3.1 6.3 6.9 1-5 4.9 1.2 6.9L12 17.8 5.8 21l1.2-6.9-5-4.9 6.9-1z"/></svg>',
info: '<svg viewBox="0 0 24 24" ' + S + '><circle cx="12" cy="12" r="10"/><path d="M12 16v-4M12 8h.01"/></svg>',
link: '<svg viewBox="0 0 24 24" ' + S + '><path d="M10 13a5 5 0 0 0 7.5.5l3-3a5 5 0 0 0-7-7l-1.7 1.7"/><path d="M14 11a5 5 0 0 0-7.5-.5l-3 3a5 5 0 0 0 7 7l1.7-1.7"/></svg>',
warn: '<svg viewBox="0 0 24 24" ' + S + '><path d="M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z"/><path d="M12 9v4M12 17h.01"/></svg>'
};
var root = document.getElementById('nb-root');
var wrap = document.getElementById('nb-wrap');
var view = document.getElementById('nb-view');
var track = document.getElementById('nb-track');
if (!root || !wrap || !view || !track) return;
/* ---------- 样式注入到 head,避免被小工具编辑器过滤 ---------- */
if (!document.getElementById('nb-style')) {
var st = document.createElement('style');
st.id = 'nb-style';
st.textContent = [
'#nb-root{container-type:inline-size;container-name:nb;}',
'.nb-wrap{--nb-h:42px;--nb-bg:#fdf0f2;--nb-fg:#d01756;--nb-ico:#d81b60;--nb-gap:10px;',
' --nb-pad:6px 14px;--nb-fs:14px;--nb-icon:28px;',
' box-sizing:border-box;width:100%;background:var(--nb-bg);border-radius:999px;',
' padding:var(--nb-pad);outline:none;cursor:pointer;user-select:none;',
' transition:background .25s ease;}',
'.nb-wrap:focus-visible{box-shadow:0 0 0 3px rgba(216,27,96,.25);}',
'.nb-view{height:var(--nb-h);overflow:hidden;position:relative;}',
'.nb-track{display:flex;flex-direction:column;transition:transform .45s cubic-bezier(.4,0,.2,1);will-change:transform;}',
'.nb-item{height:var(--nb-h);flex:0 0 var(--nb-h);display:flex;align-items:center;',
' gap:var(--nb-gap);min-width:0;}',
'.nb-icon{flex:0 0 var(--nb-icon);width:var(--nb-icon);height:var(--nb-icon);',
' border-radius:50%;display:flex;align-items:center;justify-content:center;',
' color:#fff;font-size:calc(var(--nb-icon)*.52);line-height:1;overflow:hidden;}',
'.nb-icon svg{width:58%;height:58%;display:block;}',
'.nb-icon img{width:100%;height:100%;object-fit:cover;display:block;}',
'.nb-text{flex:1 1 auto;min-width:0;color:var(--nb-fg);font-size:var(--nb-fs);',
' font-weight:600;letter-spacing:.3px;white-space:nowrap;overflow:hidden;',
' text-overflow:ellipsis;}',
'.nb-tag{flex:0 0 auto;font-size:11px;font-weight:600;color:#d01756;',
' background:rgba(208,23,86,.10);border-radius:999px;padding:2px 8px;white-space:nowrap;}',
'.nb-wrap[data-nb-dark="1"]{--nb-bg:#2b1a21;--nb-fg:#ff9ec0;}',
'.nb-wrap[data-nb-dark="1"] .nb-tag{color:#ff9ec0;background:rgba(255,158,192,.14);}',
'@container nb (max-width:420px){',
' .nb-wrap{--nb-h:36px;--nb-fs:13px;--nb-icon:24px;--nb-gap:8px;--nb-pad:5px 10px;}',
' .nb-tag{display:none;}',
'}',
'@container nb (max-width:260px){',
' .nb-wrap{--nb-h:32px;--nb-fs:12px;--nb-icon:20px;--nb-gap:6px;--nb-pad:4px 8px;}',
'}',
'@supports not (container-type:inline-size){',
' @media (max-width:480px){.nb-wrap{--nb-h:36px;--nb-fs:13px;--nb-icon:24px;--nb-gap:8px;--nb-pad:5px 10px;}.nb-tag{display:none;}}',
'}',
'@media (prefers-reduced-motion:reduce){.nb-track,.nb-wrap{transition:none!important;}}'
].join('\n');
(document.head || document.documentElement).appendChild(st);
}
/* ---------- 图标解析:内置名 / SVG / 图片 / emoji ---------- */
function esc(s) {
return String(s).replace(/[&<>"']/g, function (c) {
return { '&': '&', '<': '<', '>': '>', '"': '"', "'": ''' }[c];
});
}
function iconHTML(v) {
if (!v) return ICONS.info;
if (/^<svg[\s>]/i.test(v)) return v; /* 自定义 SVG */
if (/^(https?:\/\/|\/|\.\/)/i.test(v) || /\.(png|jpe?g|gif|webp|svg)(\?|$)/i.test(v)) {
return '<img src="' + esc(v) + '" alt="">'; /* 图片地址 */
}
if (ICONS[v]) return ICONS[v]; /* 内置图标 */
return '<span>' + esc(v) + '</span>'; /* emoji / 文字 */
}
/* ---------- 生成公告:一条 = 一个图标 + 一段文字 + 可选标签 ---------- */
NOTICES.forEach(function (n) {
var item = document.createElement('div');
item.className = 'nb-item';
var ico = document.createElement('span');
ico.className = 'nb-icon';
ico.style.background = n.color || '#d81b60';
ico.innerHTML = iconHTML(n.icon);
var txt = document.createElement('span');
txt.className = 'nb-text';
txt.textContent = n.text || '';
if (n.fg) txt.style.color = n.fg;
item.appendChild(ico);
item.appendChild(txt);
if (n.tag) {
var tag = document.createElement('span');
tag.className = 'nb-tag';
tag.textContent = n.tag;
item.appendChild(tag);
}
track.appendChild(item);
});
/* ---------- 上下滚动切换 ---------- */
var idx = 0;
var total = NOTICES.length;
function h() { return view.clientHeight || 42; }
function go(n, instant) {
if (total < 2) return;
idx = (n % total + total) % total;
if (instant) track.style.transition = 'none';
track.style.transform = 'translateY(' + (-idx * h()) + 'px)';
if (instant) requestAnimationFrame(function () { track.style.transition = ''; });
}
function next() { go(idx + 1); }
function prev() { go(idx - 1); }
/* 自动轮播 + 悬停暂停(鼠标停在条上时,滚轮/点击也不会偷偷重启计时) */
var timer = null;
var hovering = false;
function restart() {
clearInterval(timer);
if (AUTO_MS > 0 && total > 1 && !hovering) timer = setInterval(next, AUTO_MS);
}
restart();
wrap.addEventListener('mouseenter', function () { hovering = true; clearInterval(timer); });
wrap.addEventListener('mouseleave', function () { hovering = false; restart(); });
/* 滚轮:在公告条上滚一下就换一条(节流,避免触控板连跳) */
var lastWheel = 0;
view.addEventListener('wheel', function (e) {
if (!e.deltaY) return;
e.preventDefault();
var now = Date.now();
if (now - lastWheel < 320) return;
lastWheel = now;
e.deltaY > 0 ? next() : prev();
restart();
}, { passive: false });
/* 触摸上下滑 */
var startY = 0;
wrap.addEventListener('touchstart', function (e) {
startY = e.touches[0].clientY;
}, { passive: true });
wrap.addEventListener('touchend', function (e) {
var dy = e.changedTouches[0].clientY - startY;
if (Math.abs(dy) > 24) { dy < 0 ? next() : prev(); restart(); }
}, { passive: true });
/* 点击换下一条 / 键盘上下键 */
wrap.addEventListener('click', function () { next(); restart(); });
wrap.addEventListener('keydown', function (e) {
if (e.key === 'ArrowDown' || e.key === 'ArrowRight') { e.preventDefault(); next(); restart(); }
if (e.key === 'ArrowUp' || e.key === 'ArrowLeft') { e.preventDefault(); prev(); restart(); }
});
/* 宽度变化后重新对齐行高,避免断点切换时错位 */
if (window.ResizeObserver) {
new ResizeObserver(function () { go(idx, true); }).observe(view);
} else {
window.addEventListener('resize', function () { go(idx, true); });
}
/* ---------- 深浅色自适应(系统 / 主题 class / data-theme / 父级背景) ---------- */
var mq = window.matchMedia ? window.matchMedia('(prefers-color-scheme: dark)') : null;
function parentBgIsDark() {
var el = wrap.parentElement, bg = '';
while (el && !bg) {
var c = getComputedStyle(el).backgroundColor;
if (c && c !== 'transparent' && !/rgba\(\s*0,\s*0,\s*0,\s*0\s*\)/.test(c)) bg = c;
el = el.parentElement;
}
var m = /rgba?\((\d+),\s*(\d+),\s*(\d+)/.exec(bg || '');
if (!m) return false;
return (0.2126 * (+m[1]) + 0.7152 * (+m[2]) + 0.0722 * (+m[3])) / 255 < 0.45;
}
function applyTheme() {
var hd = document.documentElement, bd = document.body;
var flag = [hd.className, bd && bd.className, hd.getAttribute('data-theme'),
hd.getAttribute('data-color-scheme'), hd.getAttribute('data-bs-theme'),
bd && bd.getAttribute('data-theme')].join(' ');
var explicit = [hd.getAttribute('data-theme'), hd.getAttribute('data-color-scheme'),
hd.getAttribute('data-bs-theme'), bd && bd.getAttribute('data-theme')].join(' ');
var dark = /\bdark\b|dark-mode|theme-dark|night-mode|\bnight\b/i.test(flag) ||
(!/\blight\b/i.test(explicit) && ((mq && mq.matches) || parentBgIsDark()));
if (dark) wrap.setAttribute('data-nb-dark', '1');
else wrap.removeAttribute('data-nb-dark');
}
applyTheme();
if (mq) {
if (mq.addEventListener) mq.addEventListener('change', applyTheme);
else if (mq.addListener) mq.addListener(applyTheme);
}
if (window.MutationObserver) {
var mo = new MutationObserver(applyTheme);
mo.observe(document.documentElement, { attributes: true, attributeFilter: ['class', 'style', 'data-theme', 'data-color-scheme', 'data-bs-theme'] });
if (document.body) mo.observe(document.body, { attributes: true, attributeFilter: ['class', 'style', 'data-theme'] });
}
})();
</script>原代码一字未改,边上看得到的四个圆图标、右侧小标签、胶囊底色都是它本来的样子。代码开头那段注释里写的 https://wxzcw.com/wp-content/uploads/icon.png 是本站示例地址,换成你站里真实存在的图片路径即可(下面第 ⑦ 条会讲为什么不能随便填)。
改公告只用动脚本最上面的 NOTICES 数组:icon 填内置名(file / gift / bell / star / info / link / warn)、emoji、整段 <svg> 或图片地址都行;color 是这一条的图标底色,tag 是右侧小标签,不需要就删掉那一项。
原版实测出的问题
① 一页放两份就串台:第一份 8 条,第二份空白
四个容器全用 getElementById 定位,而 id 在一页里只能有一个。把整段复制两份实测:
| 检查项 | 结果 |
|---|---|
| 公告条容器 | 2 个 |
| 第一份里的公告条数 | 8 条(4 条被追加了两遍) |
| 第二份里的公告条数 | 0 条(整块空白) |
| click / wheel 监听 | 各 2 个,全绑在第一份上 |
| 自动轮播计时器 | 2 个同时跑 |
原因很直接:第二份脚本 getElementById('nb-track') 拿到的还是第一个 track,于是又往里追加了一遍 4 条;它自己的容器从头到尾没被碰过。样式那边用 getElementById('nb-style') 判重倒是挡住了重复注入,但只挡了样式,没挡脚本。
这种「一个侧栏 + 一个页脚都放公告」的用法很常见,一放就露馅。
② 鼠标停在公告条上,整页滚不动
滚轮那段写了 e.preventDefault() 并注册成 {passive:false}。实测派发一个 deltaY=120 的滚轮事件,defaultPrevented 是 true——公告条确实换了一条,但页面滚动被一起拦掉了。文章读一半,鼠标不小心扫过这条 42px 高的胶囊,滚轮就失灵,体验很别扭。
③ 手机上一滑,公告切了、页面也跟着滚
原版只注册了 touchstart 和 touchend,实测 touchmove 监听数 0,也没在任何地方阻止默认行为。所以手指在公告条上滑一下:公告切一条,页面同时往下滚一截,两个响应叠在一起。想要「只切公告」就得在方向确定后主动拦一次。
④ 公告文字选不中,也复制不了
容器写了 user-select:none,计算值实测就是 none;再加上 click 一律 next(),手一碰就切走。想复制公告里的日期、链接或群号,根本没机会选中。对一个「通知」组件来说这挺要命。
⑤ 写了「减少动态效果」,自动轮播却照跑
CSS 里那段 @media (prefers-reduced-motion:reduce) 只把 transition 关成 0s,实测把系统设成减弱动态效果后,setInterval 仍然是 1 个,公告条照样每 4.5 秒跳一次。真正需要停的是自动轮播,不是过渡动画。
另外切到别的标签页时计时器也不会停,回来容易连跳好几条;原版没有 visibilitychange 处理。
⑥ 4 个硬编码 id + 没有前缀的类名
nb-root / nb-wrap / nb-view / nb-track / nb-style 共 5 个 id,类名是 nb-wrap、nb-item 这类两字母短名,颜色变量叫 --nb-h,深色标记叫 data-nb-dark。CSS 是全局的,.nb-item、.nb-tag 这种名字跟主题、会员插件撞上只是时间问题;id 选择器特异性还比类高,撞了以后想覆盖得写更狠的选择器。
JustNews 里 .card、.hd、.bd 这类短名不少,这类污染排查起来最费时间。
⑦ 图标地址没有协议白名单
原版判断图片只看「开头像 URL」或「结尾像图片后缀」,两条是「或」的关系。把 icon 换成几个特殊值实测:
| 填入的 icon | 原版拼出的 HTML |
|---|---|
https://wxzcw.com/i.png |
<img src="https://wxzcw.com/i.png"> ✓ |
/wp-content/i.svg |
<img src="/wp-content/i.svg"> ✓ |
javascript:alert(1)//x.png |
<img src="javascript:..."> |
data:text/html;base64,...png |
<img src="data:..."> |
<img src> 不会执行脚本,但这属于「不该拼进属性的东西被拼进来了」;NOTICES 常常是从别处复制或由后端拼的,多一道白名单更稳。修复版只放行 https://、/、./ 开头且后缀是图片的值,其余一律当文字显示——实测上面两个特殊值都变成了 <span>。
顺带再提醒一次:注释里那个 https://wxzcw.com/wp-content/uploads/icon.png 是本站示例地址,别照抄进 NOTICES,请换成你站里真实存在的图片路径。
说句公道话:一条一「标」、容器查询做响应式、跟着主题深浅色走,这几个思路都很好,修复版只是把作用域和交互理顺,外观骨架沿用原版。
修复版 · 自包含 + 一页可放多份
<!--
上下滚动公告条 · 自包含修复版(wxz-nb- 前缀,一页可放多份)
用法:整段复制到 WordPress 后台 → 外观 → 小工具 →「自定义 HTML」
经典编辑器请用「文本」模式,别用可视化
改公告:只动下面 NOTICES 数组;一页放第二份时,给第二个容器加
data-wxz-nb-notices='[{"icon":"bell","text":"第二条"}]' 即可各自不同
站点若过滤 script 标签:把 <style> 挪到「额外 CSS」,脚本用 WPCode 插到页脚
-->
<div class="wxz-nb-root" data-wxz-nb>
<div class="wxz-nb-wrap" tabindex="0" role="region"
aria-label="站点公告,滚动或点击查看下一条" title="滚轮 / 上下滑 / 点击 切换公告">
<div class="wxz-nb-view"><div class="wxz-nb-track"></div></div>
</div>
</div>
<script>
(function () {
function boot() {
/* 整段复制两次时只初始化一次,容器仍可放多份;否则两份脚本会把每条公告渲染两遍 */
if (window.__wxzNbBooted) return;
window.__wxzNbBooted = true;
/* ① 只改这里:一条一个对象 = 一个图标 + 一段文字 + 可选标签
icon 内置名 file/gift/bell/star/info/link/warn,也可 emoji、整段 <svg>、图片地址
图片地址只放行 https://、/、./ 开头;注释里的 https://wxzcw.com/wp-content/uploads/icon.png 是本站示例,换成你站里真实存在的图片路径 */
var NOTICES = [
{ icon: 'file', color: '#d81b60', text: '已恢复正常更新,欢迎获取资源 - 2026.10.23' },
{ icon: 'gift', color: '#7c4dff', text: '新增 3 款侧边栏小工具,欢迎自取', tag: '新品' },
{ icon: 'bell', color: '#f59e0b', text: '站点夜间维护:今晚 23:00 - 24:00', tag: '通知' },
{ icon: 'star', color: '#0ea5e9', text: '深色模式自适应版本已上线', tag: '更新' }
];
var AUTO_MS = 4500; /* 自动轮播间隔,0 关闭 */
var WHEEL_HOLD = false; /* true = 滚轮停在条上时拦住页面滚动;默认 false,不劫持主题滚动 */
var S = 'fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"';
var ICONS = {
file: '<svg viewBox="0 0 24 24" ' + S + '><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><path d="M14 2v6h6"/><path d="M8 13h8M8 17h5"/></svg>',
gift: '<svg viewBox="0 0 24 24" ' + S + '><path d="M20 12v9H4v-9M2 7h20v5H2zM12 22V7"/><path d="M12 7H7.5a2.5 2.5 0 0 1 0-5C11 2 12 7 12 7zM12 7h4.5a2.5 2.5 0 0 0 0-5C13 2 12 7 12 7z"/></svg>',
bell: '<svg viewBox="0 0 24 24" ' + S + '><path d="M18 8a6 6 0 0 0-12 0c0 7-3 9-3 9h18s-3-2-3-9"/><path d="M13.7 21a2 2 0 0 1-3.4 0"/></svg>',
star: '<svg viewBox="0 0 24 24" ' + S + '><path d="m12 2 3.1 6.3 6.9 1-5 4.9 1.2 6.9L12 17.8 5.8 21l1.2-6.9-5-4.9 6.9-1z"/></svg>',
info: '<svg viewBox="0 0 24 24" ' + S + '><circle cx="12" cy="12" r="10"/><path d="M12 16v-4M12 8h.01"/></svg>',
link: '<svg viewBox="0 0 24 24" ' + S + '><path d="M10 13a5 5 0 0 0 7.5.5l3-3a5 5 0 0 0-7-7l-1.7 1.7"/><path d="M14 11a5 5 0 0 0-7.5-.5l-3 3a5 5 0 0 0 7 7l1.7-1.7"/></svg>',
warn: '<svg viewBox="0 0 24 24" ' + S + '><path d="M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z"/><path d="M12 9v4M12 17h.01"/></svg>'
};
/* ② 样式只注入一次,全部 wxz-nb- 前缀,不出现 html / body / * 选择器 */
if (!document.getElementById('wxz-nb-style')) {
var st = document.createElement('style');
st.id = 'wxz-nb-style';
st.textContent = [
'.wxz-nb-root{width:100%;max-width:760px;margin:0 auto;container-type:inline-size;container-name:wxznb;}',
'.wxz-nb-wrap{--wxz-nb-h:42px;--wxz-nb-bg:#fdf0f2;--wxz-nb-fg:#d01756;--wxz-nb-gap:10px;',
' --wxz-nb-pad:6px 14px;--wxz-nb-fs:14px;--wxz-nb-icon:28px;',
' box-sizing:border-box;width:100%;background:var(--wxz-nb-bg);border-radius:999px;',
' padding:var(--wxz-nb-pad);outline:none;cursor:pointer;user-select:text;',
' touch-action:pan-y;transition:background .25s ease;}',
'.wxz-nb-wrap:focus-visible{box-shadow:0 0 0 3px rgba(216,27,96,.25);}',
'.wxz-nb-view{height:var(--wxz-nb-h);overflow:hidden;position:relative;}',
'.wxz-nb-track{display:flex;flex-direction:column;',
' transition:transform .45s cubic-bezier(.4,0,.2,1);will-change:transform;}',
'.wxz-nb-item{height:var(--wxz-nb-h);flex:0 0 var(--wxz-nb-h);display:flex;',
' align-items:center;gap:var(--wxz-nb-gap);min-width:0;}',
'.wxz-nb-icon{flex:0 0 var(--wxz-nb-icon);width:var(--wxz-nb-icon);height:var(--wxz-nb-icon);',
' border-radius:50%;display:flex;align-items:center;justify-content:center;',
' color:#fff;font-size:calc(var(--wxz-nb-icon)*.52);line-height:1;overflow:hidden;}',
'.wxz-nb-icon svg{width:58%;height:58%;display:block;}',
'.wxz-nb-icon img{width:100%;height:100%;object-fit:cover;display:block;}',
'.wxz-nb-text{flex:1 1 auto;min-width:0;color:var(--wxz-nb-fg);font-size:var(--wxz-nb-fs);',
' font-weight:600;letter-spacing:.3px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}',
'.wxz-nb-tag{flex:0 0 auto;font-size:11px;font-weight:600;color:#d01756;',
' background:rgba(208,23,86,.10);border-radius:999px;padding:2px 8px;white-space:nowrap;}',
'.wxz-nb-wrap[data-wxz-nb-dark="1"]{--wxz-nb-bg:#2b1a21;--wxz-nb-fg:#ff9ec0;}',
'.wxz-nb-wrap[data-wxz-nb-dark="1"] .wxz-nb-tag{color:#ff9ec0;background:rgba(255,158,192,.14);}',
'@container wxznb (max-width:420px){',
' .wxz-nb-wrap{--wxz-nb-h:36px;--wxz-nb-fs:13px;--wxz-nb-icon:24px;',
' --wxz-nb-gap:8px;--wxz-nb-pad:5px 10px;}',
' .wxz-nb-tag{display:none;}',
'}',
'@container wxznb (max-width:260px){',
' .wxz-nb-wrap{--wxz-nb-h:32px;--wxz-nb-fs:12px;--wxz-nb-icon:20px;',
' --wxz-nb-gap:6px;--wxz-nb-pad:4px 8px;}',
'}',
'@supports not (container-type:inline-size){',
' @media (max-width:480px){.wxz-nb-wrap{--wxz-nb-h:36px;--wxz-nb-fs:13px;',
' --wxz-nb-icon:24px;--wxz-nb-gap:8px;--wxz-nb-pad:5px 10px;}.wxz-nb-tag{display:none;}}',
'}',
'@media (prefers-reduced-motion:reduce){',
' .wxz-nb-track,.wxz-nb-wrap{transition:none!important;}',
'}'
].join('\n');
(document.head || document.documentElement).appendChild(st);
}
function esc(s) {
return String(s).replace(/[&<>"']/g, function (c) {
return { '&': '&', '<': '<', '>': '>', '"': '"', "'": ''' }[c];
});
}
function iconHTML(v) {
if (!v) return ICONS.info;
if (/^<svg[\s>]/i.test(v)) return v;
/* 只放行 http(s) / 站内相对路径,其余一律当文字,不拼进 src */
if (/^(https?:\/\/|\/|\.\/)/i.test(v) && /\.(png|jpe?g|gif|webp|svg)(\?|$)/i.test(v)) {
return '<img src="' + esc(v) + '" alt="">';
}
if (ICONS[v]) return ICONS[v];
return '<span>' + esc(v) + '</span>';
}
function noticesOf(root) {
var raw = root.getAttribute('data-wxz-nb-notices');
if (raw) { try { var a = JSON.parse(raw); if (a && a.length) return a; } catch (e) {} }
return NOTICES;
}
var reduce = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)');
/* ③ 一页多份:每个 [data-wxz-nb] 独立一份状态和计时器,互不串台 */
Array.prototype.forEach.call(document.querySelectorAll('[data-wxz-nb]'), function (root) {
var wrap = root.querySelector('.wxz-nb-wrap');
var view = root.querySelector('.wxz-nb-view');
var track = root.querySelector('.wxz-nb-track');
if (!wrap || !view || !track) return;
var list = noticesOf(root);
list.forEach(function (n) {
var item = document.createElement('div');
item.className = 'wxz-nb-item';
var ico = document.createElement('span');
ico.className = 'wxz-nb-icon';
ico.style.background = n.color || '#d81b60';
ico.innerHTML = iconHTML(n.icon);
var txt = document.createElement('span');
txt.className = 'wxz-nb-text';
txt.textContent = n.text || '';
if (n.fg) txt.style.color = n.fg;
item.appendChild(ico);
item.appendChild(txt);
if (n.tag) {
var tag = document.createElement('span');
tag.className = 'wxz-nb-tag';
tag.textContent = n.tag;
item.appendChild(tag);
}
track.appendChild(item);
});
var idx = 0, total = list.length;
function h() { return view.clientHeight || 42; }
function go(n, instant) {
if (total < 2) return;
idx = (n % total + total) % total;
if (instant) track.style.transition = 'none';
track.style.transform = 'translateY(' + (-idx * h()) + 'px)';
if (instant) requestAnimationFrame(function () { track.style.transition = ''; });
}
function next() { go(idx + 1); }
function prev() { go(idx - 1); }
/* 减弱动态效果时连自动轮播一起停,不只是关 transition */
var timer = null, hovering = false;
function autoOK() {
return AUTO_MS > 0 && total > 1 && !hovering && !(reduce && reduce.matches);
}
function restart() {
clearInterval(timer);
if (autoOK() && !document.hidden) timer = setInterval(next, AUTO_MS);
}
restart();
wrap.addEventListener('mouseenter', function () { hovering = true; clearInterval(timer); });
wrap.addEventListener('mouseleave', function () { hovering = false; restart(); });
/* 切到后台标签页时暂停,回来不会连跳好几条 */
document.addEventListener('visibilitychange', restart);
if (reduce) {
var onReduce = function () { restart(); };
if (reduce.addEventListener) reduce.addEventListener('change', onReduce);
else if (reduce.addListener) reduce.addListener(onReduce);
}
/* ④ 滚轮默认不拦页面滚动;要原来那种「停在条上就滚不动页面」把 WHEEL_HOLD 改成 true */
var lastWheel = 0;
view.addEventListener('wheel', function (e) {
if (!e.deltaY) return;
var now = Date.now();
if (now - lastWheel < 320) return;
lastWheel = now;
if (WHEEL_HOLD) e.preventDefault();
e.deltaY > 0 ? next() : prev();
restart();
}, { passive: !WHEEL_HOLD });
/* ⑤ 触摸单响应:方向确定后只切一条,并阻止同一手势继续滚页面 */
var startY = 0, swiped = false;
wrap.addEventListener('touchstart', function (e) {
startY = e.touches[0].clientY;
swiped = false;
}, { passive: true });
wrap.addEventListener('touchmove', function (e) {
if (swiped) return;
var dy = e.touches[0].clientY - startY;
if (Math.abs(dy) > 24) {
swiped = true;
if (e.cancelable) e.preventDefault();
dy < 0 ? next() : prev();
restart();
}
}, { passive: false });
/* ⑥ 选文字时不切条,公告内容终于能复制了 */
wrap.addEventListener('click', function () {
var sel = window.getSelection && window.getSelection().toString();
if (sel) return;
next();
restart();
});
wrap.addEventListener('keydown', function (e) {
if (e.key === 'ArrowDown' || e.key === 'ArrowRight') { e.preventDefault(); next(); restart(); }
if (e.key === 'ArrowUp' || e.key === 'ArrowLeft') { e.preventDefault(); prev(); restart(); }
});
if (window.ResizeObserver) {
new ResizeObserver(function () { go(idx, true); }).observe(view);
} else {
window.addEventListener('resize', function () { go(idx, true); });
}
/* ⑦ 深浅色自适应,属性名也带前缀;父级背景读取失败时按浅色处理 */
var mq = window.matchMedia ? window.matchMedia('(prefers-color-scheme: dark)') : null;
function parentBgIsDark() {
try {
var el = wrap.parentElement, bg = '';
while (el && !bg) {
var c = getComputedStyle(el).backgroundColor;
if (c && c !== 'transparent' && !/rgba\(\s*0,\s*0,\s*0,\s*0\s*\)/.test(c)) bg = c;
el = el.parentElement;
}
var m = /rgba?\((\d+),\s*(\d+),\s*(\d+)/.exec(bg || '');
if (!m) return false;
return (0.2126 * (+m[1]) + 0.7152 * (+m[2]) + 0.0722 * (+m[3])) / 255 < 0.45;
} catch (e) { return false; }
}
function applyTheme() {
var hd = document.documentElement, bd = document.body;
var flag = [hd.className, bd && bd.className, hd.getAttribute('data-theme'),
hd.getAttribute('data-color-scheme'), hd.getAttribute('data-bs-theme'),
bd && bd.getAttribute('data-theme')].join(' ');
var explicit = [hd.getAttribute('data-theme'), hd.getAttribute('data-color-scheme'),
hd.getAttribute('data-bs-theme'), bd && bd.getAttribute('data-theme')].join(' ');
var dark = /\bdark\b|dark-mode|theme-dark|night-mode|\bnight\b/i.test(flag) ||
(!/\blight\b/i.test(explicit) && ((mq && mq.matches) || parentBgIsDark()));
if (dark) wrap.setAttribute('data-wxz-nb-dark', '1');
else wrap.removeAttribute('data-wxz-nb-dark');
}
applyTheme();
if (mq) {
if (mq.addEventListener) mq.addEventListener('change', applyTheme);
else if (mq.addListener) mq.addListener(applyTheme);
}
if (window.MutationObserver) {
var mo = new MutationObserver(applyTheme);
mo.observe(document.documentElement, { attributes: true, attributeFilter: ['class', 'style', 'data-theme', 'data-color-scheme', 'data-bs-theme'] });
if (document.body) mo.observe(document.body, { attributes: true, attributeFilter: ['class', 'style', 'data-theme'] });
}
});
}
/* 小工具里的脚本执行时,后面的侧栏容器可能还没解析完;等 DOM 齐了再一次性初始化 */
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', boot, { once: true });
} else {
boot();
}
})();
</script>外观没动,改动清单:
- 去掉全部硬编码 id:容器用
data-wxz-nb标记,脚本querySelectorAll遍历,每个容器各自querySelector找自己的部件,状态、计时器互不共享。实测一页放两份是 4 条 + 1 条(第二份用data-wxz-nb-notices单独配了内容),样式只注入 1 次、计时器 1 个。 - 加单例锁 + 等 DOM 齐了再初始化:整段复制两次时第二份脚本直接返回,不会把每条公告渲染两遍;小工具里的脚本执行时侧栏可能还没解析完,所以挂在
DOMContentLoaded上,实测第二份容器也能被初始化到。 - 滚轮默认不拦页面滚动:实测
defaultPrevented=false、监听是passive:true。想要原来那种「停在条上就滚不动页面」,把WHEEL_HOLD改成true即可。 - 触摸改成单响应:
touchmove里方向超过 24px 就切一条并preventDefault一次,实测touchmove监听 1 个,同一手势不再既切公告又滚页面。 - 文字能选中、能复制:
user-select:text,点击前先看选区,实测选中「已恢复正常更新…」后再点,transform仍是translateY(0px),不切条。 - 减弱动态效果真的停:实测
intervals=0,连自动轮播一起停;再加visibilitychange,切后台暂停、回来不连跳。 - 图标地址加白名单:非图片 URL 一律当文字,不再拼进
src。 - 类名、变量、属性、样式 id 全带
wxz-nb-前缀:DOM 里零硬编码 id。
| 检查项 | 原版 | 修复版 |
|---|---|---|
| 一页两份(条数) | 8 / 0 | 4 / 1 |
| 硬编码 id | 5 个 | 0 |
| 滚轮拦页面 | 是 | 否(可开) |
| touchmove 监听 | 0 | 1 |
user-select |
none | text |
| 减弱动态效果下的计时器 | 1 | 0 |
| 特殊协议被拼进 src | 2 例 | 0 |
主题这边做了装 / 不装的逐项对比:JustNews 模拟环境里 fixed 顶栏 z-index:100、侧栏 sticky top:80px、html / body 的 overflow-x 都是 visible、小工具里 code 的颜色 rgb(208,23,86)、导航点击计数 1、JS 报错 0——装前装后完全一致。390 和 1200 两档横向溢出都是 0,公告条宽度分别是 318px / 760px,行高按容器查询自动落到 36px / 42px。
预览也实测过:模拟代码块插件的新窗口(顶条高 50、舞台框从 70 起、390 宽),原版和修复版都渲染出 4 条公告,胶囊落在框内 (38,117)、宽 314px,不压顶条,框内和整页横向溢出都是 0,JS 报错 0。这段代码没有 position:fixed、没有往 body 上挂元素,往 head 追加样式的写法在预览文档里也正常。
怎么调
- 改公告:只动
NOTICES。一条一个对象,icon / color / fg / text / tag各管各的,删掉tag那项就没有右侧标签。 - 换图标:内置 7 种名、直接写 emoji、写整段
<svg>、或填自己的图片地址。自定义 SVG 只填自己写的,别填来路不明的片段。 - 改轮播:
AUTO_MS是间隔毫秒,改成0关闭;WHEEL_HOLD控制滚轮是否拦页面滚动。 - 改配色和尺寸:CSS 里
--wxz-nb-h / -bg / -fg / -icon / -fs是行高、底色、字色、图标直径、字号,浅色深色两套值都在同一个块里。图标底色是每条公告自己的color,跟这里不冲突。 - 一页放多份:复制两段整段代码即可(脚本有单例锁,不会重复渲染);想让第二份显示不同公告,给它的容器加
data-wxz-nb-notices='[{"icon":"bell","text":"侧栏独立公告"}]'。实测两份各自独立、只注入一份样式。 - 深色模式:跟着系统
prefers-color-scheme、主题 class /data-theme和父级背景走,一般不用管;主题夜间切换是改html或body的属性,内置的MutationObserver会跟上。
为什么类名带 wxz-nb- 前缀
CSS 是全局生效的,没有作用域。只要把 <style> 加进页面,里面的规则就作用于整个站点,而不只是你粘贴的那一块。
像 .nb-item、.nb-tag、.nb-wrap 这种名字撞车概率不低。JustNews 里有 .card、.hd、.bd 这类短名,会员插件、WPOPT 的优化样式也都在同一张样式表里;你在不知道的地方改了它们的样式,站上别处就跟着变样,而且不报错,最难查。
所以修复版做了三件事:
- 所有类名、CSS 变量、data 属性、样式 id 都带
wxz-nb-前缀,照抄时别图省事改回短名。 - 样式里 0 个
html/body/*选择器,实测注入前后body的overflow-x始终是visible,不会动到主题的全局布局;也没有position:fixed和document.body.appendChild,预览新窗口里不会盖住顶部返回条。 - 一个 id 都不用,容器靠
data-wxz-nb找,同一页放几份都不打架。
想改类名,CSS 和 HTML 里的类名要一起改,只改一处会整个失效。另外这套代码不碰 copy 事件,和代码块插件自带的「复制加版权」各管各的,不会叠加。
改的时候注意这几点
- WordPress 小工具请用「自定义 HTML」,经典编辑器切到「文本」模式粘贴,别在「可视化」模式下粘——可视化会把
<script>、换行和引号改掉,粘完就是一堆纯文字。 - 站点过滤了脚本标签:把
<style>挪到「外观 → 自定义 → 额外 CSS」,脚本用 WPCode / Insert Headers and Footers 插到页脚;原版注释里也是这么交代的。 - 引号别被弯引号化:经典编辑器会过
wptexturize。本页代码块里的引号都已经转成实体并标了escaped="on",点「复制全文」粘就没问题;别手动框选页面上的代码,框选会把转义弄丢。 - 注释里的图标地址是占位:
https://wxzcw.com/wp-content/uploads/icon.png换成自己的路径,别让访客去请求一个不存在的域名。 - 自定义 SVG 只填自己写的:它走的是
innerHTML,来路不明的片段别往NOTICES里塞。 - 公告文字别写太长:单行
nowrap + ellipsis,窄屏会省略;390 宽下右侧tag会自动隐藏给正文让位。 - 一页多份靠
data-wxz-nb-notices区分内容,不是复制两份NOTICES;脚本有单例锁,第二份里的NOTICES不会被读到。 - 纯装饰层记得写
pointer-events:none:这份代码没有 fixed 层所以不涉及,但自己加返回顶部、挂件时一定要加,不然透明盒子照样拦点击。
怎么用
整段(HTML + <script>)粘在一起即可,不依赖 jQuery、不加载任何外部文件、不请求第三方接口。
- WordPress:外观 → 小工具 → 侧栏 / 页脚加一个「自定义 HTML」。
- 文章 / 页面内:经典编辑器切「文本」模式粘贴。
- 子主题:HTML 放进
footer.php或模板,脚本塞进wp_footer钩子;用钩子的情况下document.readyState通常已经不是loading,脚本会直接初始化,没问题。 - 改完清一次缓存:WPOPT 开了 JS / CSS 合并或页面缓存时,保存后顺手清一下,不然看到的还是旧的那份。
两个小提醒:
- 样式只留一份:修复版已经按
getElementById('wxz-nb-style')判重,复制两份也只注入一次;手动拆到「额外 CSS」的话就别再留脚本里那段注入了。 - 别把整段拆开粘:HTML 容器和脚本分开放时,脚本初始化那一刻容器必须已在 DOM 里,否则那一份不会渲染。
兼容性
@container 容器查询需要 Chrome 105+ / Safari 16+ / Firefox 110+;老浏览器走 @supports not (container-type:inline-size) 里的视口兜底,只是「侧栏窄但视口宽」时字号不会缩,文字有省略号兜住,不会撑破布局。ResizeObserver 不支持时退化成 resize 监听。
其余都是老浏览器就有的东西:CSS 变量(IE11 以上)、matchMedia、MutationObserver、visibilitychange、textContent。prefers-reduced-motion 和 prefers-color-scheme 不支持时按「正常动效 + 浅色」处理,不影响主功能。iOS Safari 上 transform 过渡走合成层,4.5 秒一次的轮播没有压力。
代码仅供学习交流,禁止商用。更多 网站美化 代码,前往 维形筑网 www.wxzcw.com。
作者:Flechazo
如若转载,请注明出处:维形筑网 https://wxzcw.com