上下滚动公告条:一条公告一个「标」,滚一下换一条

侧栏或页脚挂一条浅粉胶囊公告,每条公告配一个自己的圆形图标和底色,右边还能带「新品」「通知」这类小标签。滚轮滚一下、手指上下滑一下、点一下,都会换到下一条;不操作就自己轮播。这种组件用 overflow:hidden 加一条纵向 transform 就能做,不依赖任何库。

这份代码本身写得比大多数流传片段整齐:图标内置了 7 种、深浅色会跟着主题和系统走、还写了 prefers-reduced-motion。但实际用起来还是踩了一串坑,最硬的一条是 一页放两份就串台——第一份变成 8 条、第二份一片空白;另外 鼠标停在公告条上,整页都滚不动了。下面先放原版和逐条实测,再给一份自包含的修复版。本站的 公告栏、悬浮挂件 和 网站美化 栏目里还有不少这类小工具,写法可以对照着看。

原版 · 实际效果

HTML上下滚动公告条 · 原版实际效果
<!--
  上下滚动公告条 · 复刻截图(浅粉胶囊 + 玫红圆图标 + 红字)
  特性:① 每条公告一个「标」:独立图标 + 独立底色 + 可选右侧标签
        ② 滚轮 / 触摸上下滑 / 点击 / 自动轮播,滚一下换一条
        ③ 图标可改:内置名 / 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 { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[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,请换成你站里真实存在的图片路径。

说句公道话:一条一「标」、容器查询做响应式、跟着主题深浅色走,这几个思路都很好,修复版只是把作用域和交互理顺,外观骨架沿用原版。

修复版 · 自包含 + 一页可放多份

HTML上下滚动公告条 · 自包含修复版
<!--
  上下滚动公告条 · 自包含修复版(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 { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[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

赞 (0)
双环旋转发光挂件:两圈反向匀速转,纯 CSS 不依赖 JS
上一篇 2026年11月3日 上午12:38
大眼睛时钟挂件:瞳孔跟着鼠标转,窄栏日期自动变短
下一篇 2026年11月3日 上午7:52

相关推荐

维 形 筑 网