底部悬浮推广横幅:桌面胶囊手机全宽,一页放两份也不串台

页面底部挂一条薄薄的推广胶囊:电脑端居中 400×64、离底 10px,手机端自动撑满屏宽、贴底、去圆角,点 × 记 24 小时不再弹。这份代码是纯原生的,不依赖 jQuery,内置一张 SVG 占位图,连「脚本被编辑器过滤掉」都留了纯 CSS 文字兜底,在流传的小工具片段里算想得挺周全的。

但真放进 WordPress 侧栏或页脚,还是踩了一串坑,最硬的一条是老浏览器缺 requestAnimationFrame 时,脚本跑到一半报错,横幅被自己的 opacity:0 永久藏掉;另外一页放两份,第二份永远不加载图片、URLSearchParams 一报错,图片 / 链接 / × 全失效、z-index:99999 直接盖住会员弹窗。下面先放原版(逻辑一字未改,只把中性占位文案换成本站信息)和逐条实测,再给一份自包含的修复版。本站的 悬浮挂件、广告位 和 网页美化 栏目里还有不少这类小组件,写法可以对照着看。

原版 · 实际效果

HTML底部悬浮横幅 · 原版实际效果
<!--
  维形筑网 · 通用底部悬浮推广横幅 · 纯原生 HTML / CSS / JS,零依赖
  适用:WordPress / Typecho / Hexo / 静态 HTML / 任意 CMS

  【贴站点时复制哪一段】
  只复制下面的样式块、div 骨架、脚本块这三段(从样式标签到脚本结束)。
  「底部悬浮横幅_预览.html」是双击看效果用的完整网页,不要整份贴进小工具。

  【前台不显示的排查顺序】
  1) 之前点过 × → 浏览器记了 24 小时。本版已换记录键(v2),旧记录自动失效;
     也可在地址后加 ?fxbar_reset=1 清记录,或 ?fxbar_force=1 强制显示。
  2) 编辑器过滤了 <script> → 本版样式与兜底内容不依赖脚本,横幅仍可见,
     只是 × 不生效。把 <script> 内容用 WPCode / Insert Headers and Footers 插页脚即可。
  3) 确认贴的是「代码/文本」模式,不是可视化模式里当成纯文字。
  4) 祖先元素带 transform / filter 时 fixed 会相对它定位,把片段放 body 末尾可避开。

  行为:
    · 电脑端:底部居中薄胶囊,默认 400×64px,左右留白,离底 10px
    · 手机端:撑满屏宽、无左右边距、贴底、去圆角,图片等比不裁切
      判别取「视口 ≤767px」∪「屏幕 ≤767px」,老站没写 viewport meta 也能命中
    · 图片:按原始比例缩放,不拉伸;桌面可设高度上限(超出用 cover 裁切,不拉伸)
    · 关闭:× 记 localStorage,默认 24 小时内不再弹出;清缓存或改 KEY 重置

  换自己的广告图:改 CONFIG.img(桌面)/ CONFIG.imgMobile(手机,留空复用)
  示例:上传到 https://wxzcw.com/ 的媒体库后,把图片地址填进来
  点击跳转示例:https://wxzcw.com/
-->
<style id="fxbar-css">
#fxbar{position:fixed;left:50%;transform:translateX(-50%);bottom:10px;
  width:min(var(--fxbar-w,400px), calc(100% - 32px));max-width:calc(100vw - 32px);
  height:var(--fxbar-h,64px);z-index:99999;border-radius:12px;overflow:hidden;
  background:linear-gradient(100deg,#25105a,#4a1c92 55%,#7a1f6c);
  box-shadow:0 6px 20px rgba(20,10,50,.18);
  margin:0;padding:0;opacity:1;transition:opacity .35s ease}
#fxbar,#fxbar *{box-sizing:border-box}
#fxbar.fxbar-init{opacity:0}
#fxbar.fxbar-init.is-in{opacity:1}
#fxbar .fxbar-link{display:block;width:100%;height:100%;margin:0;padding:0;
  border:0;text-decoration:none;background:none;position:relative}
/* 脚本被过滤时的兜底内容:纯 CSS 文字,Unicode 转义不依赖页面 charset */
#fxbar .fxbar-link::before{content:"维形筑网 · 立即访问";
  position:absolute;inset:0;display:flex;align-items:center;justify-content:center;
  color:#fff;font:700 17px/1 -apple-system,BlinkMacSystemFont,"Microsoft YaHei",sans-serif;
  letter-spacing:1px}
#fxbar.has-img .fxbar-link::before{display:none}
#fxbar .fxbar-img{display:none;width:100%;height:100%;object-fit:cover;
  object-position:center;margin:0;padding:0;border:0;border-radius:0}
#fxbar.has-img .fxbar-img{display:block}
#fxbar.fxbar-nocrop .fxbar-img{height:auto;object-fit:contain}
#fxbar .fxbar-link{min-height:var(--fxbar-h,64px)}
#fxbar .fxbar-close{position:absolute;top:5px;right:5px;z-index:2;
  width:20px;height:20px;margin:0;padding:0;border:0;border-radius:50%;
  background:rgba(0,0,0,.38);display:grid;place-items:center;cursor:pointer;
  -webkit-appearance:none;appearance:none;transition:background .2s}
#fxbar .fxbar-close:hover{background:rgba(0,0,0,.65)}
#fxbar .fxbar-close svg{width:12px;height:12px;display:block}
/* 手机态:高度交回图片按原始比例撑起,不裁切 */
#fxbar.fxbar-mobile{left:0;right:0;width:100%;max-width:none;bottom:0;
  transform:none;height:auto;border-radius:0;box-shadow:0 -3px 14px rgba(0,0,0,.1)}
#fxbar.fxbar-mobile .fxbar-img{height:auto;object-fit:contain}
#fxbar.fxbar-mobile .fxbar-link{min-height:62px}
#fxbar.fxbar-mobile .fxbar-close{top:5px;right:7px}
@media (prefers-reduced-motion:reduce){#fxbar,#fxbar .fxbar-close{transition:none}}
</style>

<div id="fxbar" aria-label="维形筑网推广横幅">
  <a class="fxbar-link">
    <img id="fxbar-img" class="fxbar-img" alt="维形筑网">
  </a>
  <button id="fxbar-close" class="fxbar-close" type="button" aria-label="关闭横幅">
    <svg viewBox="0 0 24 24" fill="none" stroke="#fff" stroke-width="2.6" stroke-linecap="round" aria-hidden="true">
      <path d="M6 6l12 12M18 6L6 18"/>
    </svg>
  </button>
</div>

<script>
(function () {
  'use strict';

  /* ========== 1. 配置:只改这里 ========== */
  var CONFIG = {
    img: '',           // 桌面图:填媒体库里的图片地址(例如本站上传的图)
    imgMobile: '',     // 手机图:留空复用桌面图
    link: '',          // 点击跳转,如 https://wxzcw.com/;留空不可点
    hours: 24,         // 关闭后屏蔽时长
    maxWidth: 400,     // 桌面宽度 px
    desktopHeight: 64, // 桌面高度上限 px;填 0 = 不限高、完全按图片原比例
    breakpoint: 767,   // 手机判定阈值 px
    forceShow: false   // 排障用:临时改 true 可忽略关闭记录强制显示
  };
  var KEY = 'fxbar_closed_at_v2';  // 换广告想立刻重弹,改这个字符串即可

  var bar = document.getElementById('fxbar');
  var img = document.getElementById('fxbar-img');
  var link = bar && bar.querySelector('.fxbar-link');
  var closeBtn = document.getElementById('fxbar-close');
  if (!bar || !img || !link || !closeBtn) return;

  /* ========== 2. 关闭记录(隐私模式 localStorage 不可用则静默降级) ========== */
  function readClosed() {
    try { return parseInt(localStorage.getItem(KEY) || '0', 10) || 0; }
    catch (e) { return 0; }
  }
  function writeClosed(t) {
    try { localStorage.setItem(KEY, String(t)); } catch (e) {}
  }
  var qs = new URLSearchParams(location.search);
  if (qs.get('fxbar_reset') === '1') { try { localStorage.removeItem(KEY); } catch (e) {} }
  var ttl = (parseFloat(CONFIG.hours) || 24) * 3600 * 1000;
  var force = CONFIG.forceShow || qs.get('fxbar_force') === '1';
  if (!force && Date.now() - readClosed() < ttl) { bar.remove(); return; }

  /* ========== 3. 尺寸变量:限高 0 时完全交回图片比例 ========== */
  bar.style.setProperty('--fxbar-w', (parseInt(CONFIG.maxWidth, 10) || 400) + 'px');
  var dh = parseInt(CONFIG.desktopHeight, 10);
  bar.style.setProperty('--fxbar-h', dh > 0 ? dh + 'px' : 'auto');
  if (dh <= 0) bar.classList.add('fxbar-nocrop');
  if (CONFIG.link) link.href = CONFIG.link;

  /* ========== 4. 内置本站占位图(1000×160 = 6.25:1,正好适配 400×64) ==========
     文案直接写中文,预览页与本站都声明了 charset */
  var T = {
    app: '维形筑网',
    sub: '网站美化代码 · www.wxzcw.com',
    btn: '立即访问'
  };
  var SVG = '<svg xmlns="http://www.w3.org/2000/svg" width="1000" height="160" viewBox="0 0 1000 160">' +
    '<defs>' +
      '<linearGradient id="g" x1="0" y1="0" x2="1" y2="1">' +
        '<stop offset="0" stop-color="#25105A"/><stop offset=".55" stop-color="#4A1C92"/>' +
        '<stop offset="1" stop-color="#7A1F6C"/></linearGradient>' +
      '<linearGradient id="b" x1="0" y1="0" x2="1" y2="0">' +
        '<stop offset="0" stop-color="#2F7BFF"/><stop offset="1" stop-color="#59A6FF"/></linearGradient>' +
    '</defs>' +
    '<rect width="1000" height="160" fill="url(#g)"/>' +
    '<path d="M700 0h300v160H600z" fill="#FF5A5F" opacity=".13"/>' +
    '<circle cx="930" cy="20" r="56" fill="#fff" opacity=".05"/>' +
    '<g fill="#fff" opacity=".3"><circle cx="470" cy="20" r="2.5"/>' +
      '<circle cx="510" cy="34" r="2"/><circle cx="690" cy="140" r="2.5"/></g>' +
    '<rect x="34" y="30" width="100" height="100" rx="26" fill="#fff"/>' +
    '<circle cx="84" cy="80" r="34" fill="#1B53C9"/>' +
    '<path d="M84 58l13 10-5 15H76l-5-15z" fill="#fff"/>' +
    '<path d="M71 83l-11 8 4 15 12-4zM97 83l11 8-4 15-12-4zM78 106h12l-6 13z" fill="#fff" opacity=".85"/>' +
    '<text x="162" y="78" fill="#fff" font-family="Microsoft YaHei,PingFang SC,Arial Black,sans-serif" ' +
      'font-size="42" font-weight="900" letter-spacing="2">' + T.app + '</text>' +
    '<text x="164" y="112" fill="#FFD9EF" font-family="Microsoft YaHei,PingFang SC,sans-serif" ' +
      'font-size="19" font-weight="700" letter-spacing="2">' + T.sub + '</text>' +
    '<rect x="748" y="36" width="182" height="88" rx="44" fill="url(#b)"/>' +
    '<text x="839" y="92" text-anchor="middle" fill="#fff" ' +
      'font-family="Microsoft YaHei,PingFang SC,sans-serif" font-size="26" font-weight="800">' + T.btn + '</text>' +
    '</svg>';
  var builtin = 'data:image/svg+xml;charset=utf-8,' + encodeURIComponent(SVG);
  var desktop = CONFIG.img || builtin;

  /* ========== 5. 桌面 / 手机:布局与图片用同一套判别 ========== */
  function isMobile() {
    var bp = parseInt(CONFIG.breakpoint, 10) || 767;
    var narrow = window.matchMedia && window.matchMedia('(max-width:' + bp + 'px)').matches;
    var small = window.screen && window.screen.width <= bp;  /* 无 viewport meta 兜底 */
    return !!(narrow || small);
  }
  function applyMode() {
    var mobile = isMobile();
    bar.classList.toggle('fxbar-mobile', mobile);
    var want = (mobile && CONFIG.imgMobile) ? CONFIG.imgMobile : desktop;
    if (img.getAttribute('src') !== want) img.src = want;
    if (img.complete || want.indexOf('data:') === 0) bar.classList.add('has-img');
  }
  img.addEventListener('load', function () { bar.classList.add('has-img'); });
  img.addEventListener('error', function () { bar.classList.remove('has-img'); });
  applyMode();
  window.addEventListener('resize', applyMode);

  /* ========== 6. 淡入 + 关闭 ========== */
  bar.classList.add('fxbar-init');
  requestAnimationFrame(function () { bar.classList.add('is-in'); });
  var reduce = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
  closeBtn.addEventListener('click', function (e) {
    e.stopPropagation();
    writeClosed(Date.now());
    bar.classList.remove('is-in');
    setTimeout(function () { bar.remove(); }, reduce ? 0 : 360);
  });
})();
</script>

三点说明。一是占位图是脚本里拼出来的 data:image/svg+xml,不请求任何外部文件,文案已经换成维形筑网和本站网址,换成自己的广告图只改 CONFIG.img;二是横幅是 position:fixed,桌面 400px 宽,而代码块预览的舞台框只有 350px 宽,早期写法会左右各伸出白框 25px;三是宽度现在写成 min(400px, calc(100% - 32px)),预览里自动收到 318px,真实页面仍是 400px,代码块末尾不再附额外的样式段,复制到自己站点不用删任何东西。手机 390 宽下横幅本来就是全宽贴底。

原版实测出的问题

① 脚本半途报错,横幅被自己藏成透明

淡入是这么写的:先 bar.classList.add('fxbar-init')(CSS 里 .fxbar-init{opacity:0}),再靠 requestAnimationFrame 补一个 is-in 把透明度改回 1。中间任何一步抛错,is-in 永远加不上。把浏览器的 requestAnimationFrame 拿掉实测:

检查项 原版 修复版
控制台 requestAnimationFrame is not a function 无报错
横幅 opacity 0(整条消失) 1
图片 / 链接 已加载,但看不见 正常

这类「先隐藏、再靠脚本显示」的写法,在老浏览器、被优化插件延迟加载、或者脚本被截断时都会翻车。兜底内容做得再好也救不回来。

② 一页放两份,第二份不初始化

从 #fxbar-css 到 #fxbar-close,整段用了 4 个额外 id(加上模拟页面自带的是 7 个)。两段代码一起粘,getElementById('fxbar') 只拿得到文档里第一个,第二份的脚本从头到尾操作的都是别人的节点:

检查项 第一份 第二份
has-img true false
img.src data:image/svg+xml... 空
点击 × 有效 关的是第一份

第二份只剩纯 CSS 兜底文字,还盖在第一份的位置上。

③ URLSearchParams 一报错,后面全断

关闭记录那一段第一行就是 new URLSearchParams(location.search)。它在 IE 全系和部分老 Safari / 老安卓 WebView 里根本不存在,而且没有 try 包住。实测把它拿掉:

检查项 原版 修复版
控制台 URLSearchParams is not a constructor 无报错
占位图 不加载 加载
链接 / × / 淡入 全部没执行 正常

脚本从这一行直接断掉,第 3~6 段(尺寸、图片、手机判别、关闭)一行都没跑。讽刺的是,它明明写了「样式与兜底内容不依赖脚本」,结果脚本一开始就把后面全带走了。

④ z-index:99999 盖住主题弹窗

放一个 z-index:10000 的会员弹窗探针在底部,取横幅中心点做 elementFromPoint:

版本 横幅 z-index 中心点命中
原版 99999 fxbar-link(弹窗被压住)
修复版 999 probeModal(弹窗正常)

99999 基本浮在站上一切之上。WPCOM Member 的登录框、支付层、图片灯箱都会被这条广告盖住一角。

⑤ 链接和图片地址不设防

CONFIG.link 直接赋给 link.href,CONFIG.img 直接赋给 img.src,没有协议白名单。把 link 改成 javascript:alert(1) 实测,原版照写不误;修复版会拒绝并移除 href。图片地址同理,data:text/html 之类也照收。

⑥ 淡入逻辑和「关闭」都没有退路

点 × 之后原版直接 bar.remove() 把节点从 DOM 删掉,没有 show() / destroy() 之类的接口,想临时调一下只能改代码重贴。修复版改成 display:none 并留了 wxzFxbar.destroy();实测两者刷新后都不再出现,说明关闭记录本身是好的。

⑦ 短类名加通配选择器

#fxbar、.fxbar-link、.fxbar-close 都没前缀,还有一条 #fxbar,#fxbar *{box-sizing:border-box}。虽然限定在横幅内部,暂时没污染主题(装 vs 不装逐项比对全部一致),但 fxbar 这种词和广告位、推广插件撞上只是时间问题。

⑧ 预览里横幅伸出舞台框

这条不是代码 bug,是文章写法要注意的:预览舞台框 350px 宽,桌面横幅 400px,实测矩形 [400,596,400,64]、舞台框 [425,70,350,600],左右各多出 25px。现在把宽度直接写进主 CSS 的 min(),实测矩形 [441,596,318,64],完整落在白框里,不需要在代码块末尾再追加样式段——多一个 <style> 就多一次被编辑器或优化插件拆开的机会。真实页面不受影响。

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

HTML底部悬浮横幅 · 自包含修复版
<!--
  维形筑网 · 底部悬浮推广横幅(自包含修复版)
  站点:https://wxzcw.com/
  纯原生 HTML / CSS / JS,零依赖;一页可放多份,各自独立
  用法:整段(样式 + div + 脚本)粘进「自定义 HTML」小工具或页脚模板
  只改脚本顶部的 CFG;换广告图后改一下 key,旧关闭记录自动失效
-->
<style data-wxz-fxbar-style>
.wxz-fxbar{
  --wxz-fxbar-w:400px;--wxz-fxbar-h:64px;--wxz-fxbar-z:999;
  position:fixed;left:50%;transform:translateX(-50%);bottom:10px;
  width:min(var(--wxz-fxbar-w), calc(100% - 32px));max-width:calc(100vw - 32px);
  height:var(--wxz-fxbar-h);z-index:var(--wxz-fxbar-z);
  border-radius:12px;overflow:hidden;margin:0;padding:0;opacity:1;
  background:linear-gradient(100deg,#25105a,#4a1c92 55%,#7a1f6c);
  box-shadow:0 6px 20px rgba(20,10,50,.18);
  font-family:-apple-system,BlinkMacSystemFont,"Microsoft YaHei",sans-serif;
}
.wxz-fxbar,.wxz-fxbar a,.wxz-fxbar img,.wxz-fxbar button,.wxz-fxbar svg{box-sizing:border-box}
/* 淡入只在脚本完成初始化后挂上;脚本被过滤或半途报错时横幅依然可见 */
.wxz-fxbar[data-wxz-fxbar-ready="1"]{animation:wxzFxbarIn .35s ease both}
@keyframes wxzFxbarIn{from{opacity:0}to{opacity:1}}
.wxz-fxbar__link{display:block;width:100%;height:100%;margin:0;padding:0;
  border:0;text-decoration:none;background:none;position:relative;cursor:pointer}
/* 无图 / 图片加载失败时的纯 CSS 兜底文字,Unicode 转义不依赖页面 charset */
.wxz-fxbar__link::before{content:"维形筑网 · 立即访问";
  position:absolute;inset:0;display:flex;align-items:center;justify-content:center;
  color:#fff;font-size:17px;font-weight:700;line-height:1;letter-spacing:1px}
.wxz-fxbar.has-img .wxz-fxbar__link::before{display:none}
.wxz-fxbar__img{display:none;width:100%;height:100%;object-fit:cover;
  object-position:center;margin:0;padding:0;border:0;border-radius:0}
.wxz-fxbar.has-img .wxz-fxbar__img{display:block}
.wxz-fxbar.nocrop .wxz-fxbar__img{height:auto;object-fit:contain}
.wxz-fxbar__link{min-height:var(--wxz-fxbar-h)}
.wxz-fxbar__close{position:absolute;top:5px;right:5px;z-index:2;
  width:20px;height:20px;margin:0;padding:0;border:0;border-radius:50%;
  background:rgba(0,0,0,.38);display:grid;place-items:center;cursor:pointer;
  -webkit-appearance:none;appearance:none;transition:background .2s}
.wxz-fxbar__close:hover{background:rgba(0,0,0,.65)}
.wxz-fxbar__close:focus-visible,.wxz-fxbar__link:focus-visible{
  outline:2px solid #fff;outline-offset:2px}
.wxz-fxbar__close svg{width:12px;height:12px;display:block}
.wxz-fxbar.mobile{left:0;right:0;width:100%;max-width:none;bottom:0;
  transform:none;height:auto;border-radius:0;box-shadow:0 -3px 14px rgba(0,0,0,.1)}
.wxz-fxbar.mobile .wxz-fxbar__img{height:auto;object-fit:contain}
.wxz-fxbar.mobile .wxz-fxbar__link{min-height:62px}
.wxz-fxbar.mobile .wxz-fxbar__close{top:5px;right:7px}
@media (prefers-reduced-motion:reduce){
  .wxz-fxbar[data-wxz-fxbar-ready="1"]{animation:none}
  .wxz-fxbar__close{transition:none}
}
</style>

<div class="wxz-fxbar" data-wxz-fxbar role="region" aria-label="维形筑网推广横幅">
  <a class="wxz-fxbar__link" aria-label="前往维形筑网">
    <img class="wxz-fxbar__img" alt="维形筑网">
  </a>
  <button class="wxz-fxbar__close" type="button" aria-label="关闭横幅">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none"
         stroke="#fff" stroke-width="2.6" stroke-linecap="round" aria-hidden="true">
      <path d="M6 6l12 12M18 6L6 18"/>
    </svg>
  </button>
</div>

<script>
(function () {
  'use strict';
  /* 全局只建一份(resize / 实例表),但每段脚本都去接管「尚未初始化」的横幅:
     整段复制两份时两份各自可用,而不是第二份被单例锁整个挡掉 */
  var G = window.__WXZ_FXBAR__;
  var fresh = !G;
  if (fresh) G = window.__WXZ_FXBAR__ = { instances: [], ro: null, onResize: null };

  /* ========== 只改这里 ========== */
  var CFG = {
    img: '',                              /* 例:媒体库里的图片地址 */
    imgMobile: '',                        /* 例:媒体库里的手机图片地址,留空复用 */
    link: 'https://wxzcw.com/',       /* 只接受 http/https/相对路径 */
    hours: 24,
    maxWidth: 400,
    desktopHeight: 64,                    /* 0 = 不限高,按图片原比例 */
    breakpoint: 767,
    z: 999,                               /* 不再用 99999,别盖住主题弹窗 */
    key: 'wxz_fxbar_closed_at_v1'         /* 换广告后改一下即可重弹 */
  };

  /* ---------- 老浏览器兜底:不用 URLSearchParams / rAF ---------- */
  function query(name) {
    var s = location.search.replace(/^\?/, '').split('&');
    for (var i = 0; i < s.length; i++) {
      var kv = s[i].split('=');
      if (decodeURIComponent(kv[0] || '') === name) return decodeURIComponent(kv[1] || '');
    }
    return '';
  }
  function safeUrl(u) {
    if (!u) return '';
    if (/^(https?:\/\/|\/|\.\/|\.\.\/|#|data:image\/)/i.test(u)) return u;
    return '';                            /* javascript: / data:text/html 一律拒掉 */
  }
  function readNum(k) { try { return parseInt(localStorage.getItem(k) || '0', 10) || 0; } catch (e) { return 0; } }
  function writeNum(k, v) { try { localStorage.setItem(k, String(v)); } catch (e) {} }

  /* ---------- 样式只留一份(静态 style 允许被小工具编辑器保留) ---------- */
  var styles = document.querySelectorAll('style[data-wxz-fxbar-style]');
  for (var si = 1; si < styles.length; si++) styles[si].parentNode.removeChild(styles[si]);

  /* ---------- 内置占位图:SVG 命名空间是 W3C 标准,不能改成本站网址 ---------- */
  var T = {
    app: '维形筑网',
    sub: '网站美化代码 · www.wxzcw.com',
    btn: '立即访问'
  };
  var SVG = '<svg xmlns="http://www.w3.org/2000/svg" width="1000" height="160" viewBox="0 0 1000 160">' +
    '<defs>' +
      '<linearGradient id="wxz-fxbar-g" x1="0" y1="0" x2="1" y2="1">' +
        '<stop offset="0" stop-color="#25105A"/><stop offset=".55" stop-color="#4A1C92"/>' +
        '<stop offset="1" stop-color="#7A1F6C"/></linearGradient>' +
      '<linearGradient id="wxz-fxbar-b" x1="0" y1="0" x2="1" y2="0">' +
        '<stop offset="0" stop-color="#2F7BFF"/><stop offset="1" stop-color="#59A6FF"/></linearGradient>' +
    '</defs>' +
    '<rect width="1000" height="160" fill="url(#wxz-fxbar-g)"/>' +
    '<path d="M700 0h300v160H600z" fill="#FF5A5F" opacity=".13"/>' +
    '<circle cx="930" cy="20" r="56" fill="#fff" opacity=".05"/>' +
    '<g fill="#fff" opacity=".3"><circle cx="470" cy="20" r="2.5"/>' +
      '<circle cx="510" cy="34" r="2"/><circle cx="690" cy="140" r="2.5"/></g>' +
    '<rect x="34" y="30" width="100" height="100" rx="26" fill="#fff"/>' +
    '<circle cx="84" cy="80" r="34" fill="#1B53C9"/>' +
    '<path d="M84 58l13 10-5 15H76l-5-15z" fill="#fff"/>' +
    '<path d="M71 83l-11 8 4 15 12-4zM97 83l11 8-4 15-12-4zM78 106h12l-6 13z" fill="#fff" opacity=".85"/>' +
    '<text x="162" y="78" fill="#fff" font-family="Microsoft YaHei,PingFang SC,Arial Black,sans-serif" ' +
      'font-size="42" font-weight="900" letter-spacing="2">' + T.app + '</text>' +
    '<text x="164" y="112" fill="#FFD9EF" font-family="Microsoft YaHei,PingFang SC,sans-serif" ' +
      'font-size="19" font-weight="700" letter-spacing="2">' + T.sub + '</text>' +
    '<rect x="748" y="36" width="182" height="88" rx="44" fill="url(#wxz-fxbar-b)"/>' +
    '<text x="839" y="92" text-anchor="middle" fill="#fff" ' +
      'font-family="Microsoft YaHei,PingFang SC,sans-serif" font-size="26" font-weight="800">' + T.btn + '</text>' +
    '</svg>';
  var builtin = 'data:image/svg+xml;charset=utf-8,' + encodeURIComponent(SVG);

  var bars = document.querySelectorAll('[data-wxz-fxbar]');
  if (!bars.length) return;
  if (query('wxz_fxbar_reset') === '1') { try { localStorage.removeItem(CFG.key); } catch (e) {} }
  var ttl = (parseFloat(CFG.hours) || 24) * 3600 * 1000;
  var force = query('wxz_fxbar_force') === '1';
  var instances = G.instances;

  function isMobile(bp) {
    var narrow = window.matchMedia && window.matchMedia('(max-width:' + bp + 'px)').matches;
    var small = window.screen && window.screen.width <= bp;
    return !!(narrow || small);
  }
  G.onResize = function () {
    for (var i = 0; i < instances.length; i++) instances[i].applyMode();
  };

  Array.prototype.forEach.call(bars, function (bar) {
    if (bar.getAttribute('data-wxz-fxbar-init') === '1') return;
    bar.setAttribute('data-wxz-fxbar-init', '1');
    var img = bar.querySelector('.wxz-fxbar__img');
    var link = bar.querySelector('.wxz-fxbar__link');
    var closeBtn = bar.querySelector('.wxz-fxbar__close');
    if (!img || !link || !closeBtn) return;

    /* 每份可单独覆盖配置:<div data-wxz-fxbar data-wxz-fxbar-config='{"link":"..."}'> */
    var o = {}, raw = bar.getAttribute('data-wxz-fxbar-config');
    if (raw) { try { o = JSON.parse(raw) || {}; } catch (e) {} }
    var c = {};
    for (var k in CFG) if (Object.prototype.hasOwnProperty.call(CFG, k)) c[k] = CFG[k];
    for (var k2 in o) if (Object.prototype.hasOwnProperty.call(o, k2)) c[k2] = o[k2];

    if (!force && Date.now() - readNum(c.key) < ttl) { bar.parentNode.removeChild(bar); return; }

    bar.style.setProperty('--wxz-fxbar-w', (parseInt(c.maxWidth, 10) || 400) + 'px');
    var dh = parseInt(c.desktopHeight, 10);
    bar.style.setProperty('--wxz-fxbar-h', dh > 0 ? dh + 'px' : 'auto');
    bar.style.setProperty('--wxz-fxbar-z', String(parseInt(c.z, 10) || 999));
    if (dh <= 0) bar.classList.add('nocrop');
    var href = safeUrl(c.link);
    if (href) link.href = href; else link.removeAttribute('href');

    var desktop = safeUrl(c.img) || builtin;
    var mobileImg = safeUrl(c.imgMobile);
    function applyMode() {
      var mobile = isMobile(parseInt(c.breakpoint, 10) || 767);
      bar.classList.toggle('mobile', mobile);
      var want = (mobile && mobileImg) ? mobileImg : desktop;
      if (img.getAttribute('src') !== want) img.src = want;
      if (img.complete || want.indexOf('data:') === 0) bar.classList.add('has-img');
    }
    img.addEventListener('load', function () { bar.classList.add('has-img'); });
    img.addEventListener('error', function () { bar.classList.remove('has-img'); });
    applyMode();

    closeBtn.addEventListener('click', function (e) {
      e.stopPropagation();
      writeNum(c.key, Date.now());
      bar.style.display = 'none';
    });

    /* 初始化全部完成后才挂淡入;中途任何一步抛错都不会把横幅藏成 opacity:0 */
    bar.setAttribute('data-wxz-fxbar-ready', '1');
    instances.push({ bar: bar, applyMode: applyMode });
  });

  if (fresh && instances.length) {
    if (window.ResizeObserver) {
      G.ro = new ResizeObserver(G.onResize);
      G.ro.observe(document.documentElement);
    } else {
      window.addEventListener('resize', G.onResize);
    }
  }

  window.wxzFxbar = {
    count: instances.length,
    destroy: function () {
      if (G.ro) G.ro.disconnect(); else window.removeEventListener('resize', G.onResize);
      for (var i = 0; i < instances.length; i++) {
        var b = instances[i].bar;
        if (b.parentNode) b.parentNode.removeChild(b);
      }
      instances.length = 0;
      delete window.__WXZ_FXBAR__;
    }
  };
})();
</script>

改动都在细节上,外观和原版一致:

  • 淡入不再依赖脚本成功:去掉 opacity:0 的初始隐藏,改成只在初始化全部完成之后才挂 data-wxz-fxbar-ready="1" 触发一段 CSS 动画。脚本被过滤、半途报错,横幅都是正常可见的,只是没有淡入。
  • 零 id:全部换成 [data-wxz-fxbar] 遍历定位,每段脚本只接管「还没初始化」的横幅,所以整段复制两份时两份各自可用;全局的 resize / 实例表只有一份。实测样式份数 2 → 1、接管实例数 1 → 2。
  • 不用 URLSearchParams / requestAnimationFrame:查询参数手写解析,动画交给 CSS,老浏览器不再有断点和阻塞。
  • 层级降到 999,抽成 --wxz-fxbar-z,主题弹窗压得住它。
  • 地址白名单:链接只收 http/https 和相对路径,图片只收图片类 data:image/,javascript: 一律拒掉。
  • 每份可单独配:给 div 加 data-wxz-fxbar-config='{"link":"..."}' 就能覆盖默认项,不用复制两份脚本。
  • 留了接口:wxzFxbar.destroy() 移除所有横幅并断开监听;wxzFxbar.count 看当前实例数。
  • 类名全带 wxz-fxbar- 前缀,去掉通配 *,补了 :focus-visible 键盘描边。
检查项 原版 修复版
无 rAF 时横幅 opacity 0,消失 正常显示
无 URLSearchParams 报错,图片/链接/× 全失效 正常
一页两份:第二份有图 否 是
额外 id 4 个 0
与会员弹窗重叠 盖住弹窗 不盖
javascript: 链接 照常写入 拒绝
样式 / 接管实例(两份) 2 / 1 1 / 2
390 / 1200 横向溢出 0 / 0 0 / 0
装 vs 不装:顶栏 / 侧栏 / 导航 — 全部一致

怎么调

  • 换广告图:改 CFG.img(桌面)和 CFG.imgMobile(手机,留空复用前者)。代码块里的示例只写了 www.wxzcw.com,正式用之前把媒体库里的图片地址填进去即可。
  • 改点击跳转:CFG.link,默认就填了 https://wxzcw.com/;留空会移除 href,横幅变成不可点。
  • 改尺寸:maxWidth(桌面宽)、desktopHeight(填 0 = 不限高,完全按图片原比例)。
  • 改手机阈值:breakpoint,默认 767px。
  • 改层级:z,默认 999;主题有更高的浮层再往上调一点。
  • 改屏蔽时长:hours,默认 24 小时。换广告后改一下 key,访客之前点的「不再显示」就自动失效。
  • 排障:地址后加 ?wxz_fxbar_reset=1 清记录、?wxz_fxbar_force=1 强制显示。
  • 一页两份不同内容:复制两份 div,第二份加 data-wxz-fxbar-config='{"link":"https://wxzcw.com/"}';脚本整段留一份就够。
  • 临时撤掉:wxzFxbar.destroy()。

为什么类名带 wxz-fxbar- 前缀

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

像 .link、.close、#fxbar 这种名字撞车概率极高——主题、会员插件、广告位都在用。JustNews 里有 .card、.hd、.bd 这类短名,你在不知道的地方改了它们的样式,站上别处就跟着变样。实测装与不装逐项比对:顶栏 z-index:100 / 高 50、侧栏 sticky 80px、.card 背景、小工具里 code 颜色、html/body 的 overflow-x、导航点击数、JS 报错数全部一致,页面溢出 0。

所以:

  • 照抄时保留 wxz-fxbar- 前缀,连 @keyframes 名字(wxzFxbarIn)也带上了,防止和主题的 fadeIn / pulse 互相覆盖。
  • 想改类名,CSS 和 HTML 里的类名要一起改,只改一处会整个失效。
  • 修复版一个 id 都没用,靠 data-wxz-fxbar 属性定位,同一页面放几份都不打架。
  • 样式里没有 html / body / 裸 * 选择器,不会动主题的全局布局。

改的时候注意这几点

  • SVG 里那行 xmlns="http://www.w3.org/2000/svg" 千万别改:它是 W3C 从 SVG 1.0 规范起定义的 XML 命名空间,浏览器靠它把 <svg> 里的标签识别成 SVG 元素,不是站外链接、也不会发起请求。改成本站网址,整张占位图会变成空白。这是功能性标识,不属于「示例网址」。
  • 示例网址都换成自己的:代码块里写的是维形筑网和 www.wxzcw.com,正式用之前把 CFG.img / CFG.imgMobile / CFG.link 换成你自己的地址和图片路径。
  • 别用 z-index:99999:会浮在主题弹窗之上,999 通常够用。
  • 别用 id 做样式钩子:挂件很可能被放多处,用类名或 data 属性。
  • 别「先隐藏、再靠脚本显示」:脚本被优化插件延迟、被编辑器过滤、或半途报错,元素就永久消失。默认可见,动画只在初始化成功后挂。
  • 祖先带 transform / filter 时 fixed 会相对它定位:原版注释里也写了,把片段放在 body 末尾可避开。代码块预览正是利用了这一点,把横幅关在舞台框里。
  • 别在代码块末尾再追加第二个 <style>:预览宽高已经由主 CSS 的 min() 自适应,多一段样式在 WordPress 编辑器、WPOPT 合并或复制粘贴时更容易被拆坏,拆坏后 <style> 变成可见文字,预览里就会喷出一大段 CSS。
  • 改完清一次缓存:WPOPT 开了 JS / CSS 合并或页面缓存时,保存后顺手清一下,不然看到的还是旧的那份。

怎么用

整段(<style> + <div> + <script>)粘在一起即可,不依赖 jQuery、不加载任何外部文件、不请求第三方接口。

  • WordPress:外观 → 小工具 → 侧栏 / 页脚加一个「自定义 HTML」;或经典编辑器切「文本」模式贴进文章。
  • 子主题:HTML 放进 footer.php,脚本塞进 wp_footer 钩子;用钩子时 DOM 已就绪,脚本会直接初始化。
  • 一页多份:复制 div 即可,脚本整段留一份;真把整段复制两份也没问题,两段脚本会各自接管还没初始化的那份。
  • 脚本被编辑器过滤:横幅仍在(纯 CSS 兜底文字),但图片和 × 不生效;把 <script> 那段用 WPCode / Insert Headers and Footers 插到页脚即可。

两个小提醒:

  • 样式只留一份:修复版会按 style[data-wxz-fxbar-style] 判重,复制两份实测只剩 1 份;手动拆到「额外 CSS」的话就别再留静态 <style> 了。
  • 和代码块预览不冲突:这段只在自己的容器里写图片和文字,不改 body 的 overflow、不加额外的 body 级 fixed 层;预览新窗口的返回条和舞台框都不受影响,390 宽实测横幅落在框内 (20,608)、不压顶条。

兼容性

修复版刻意避开了两个新 API:URLSearchParams 换成手写解析,requestAnimationFrame 换成 CSS 动画,IE11 和老安卓 WebView 也不会在初始化阶段断掉。ResizeObserver 不支持时退化成 resize 监听,matchMedia 不支持时按桌面态处理。

其余都是老浏览器就有的东西:CSS 变量(IE11 以上)、classList、querySelectorAll、textContent、data:image/svg+xml。prefers-reduced-motion 命中时淡入动画直接关掉(实测原版 / 修复版都是 0s / none),localStorage 在无痕或隐私模式不可用时被 try 包住,静默降级成「每次都显示」,不会报错。


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

作者:Flechazo

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

赞 (0)
左上角 Logo 秋千摇摆:免查 class 的写法,和预览、冲突那点事
上一篇 2026年11月3日 下午4:02
页脚备案等美化胶囊:五个彩色标签 + 双色信息条,别让 #ft 把主题页脚改了
下一篇 2026年11月3日 下午8:10

相关推荐

维 形 筑 网