FPS 帧率显示挂件:实时看动画流畅度,双击可关

屏幕角落挂一个小小的数字,实时显示当前页面的帧率——60 是流畅,掉到 30 以下肉眼就能感觉到卡。调动画参数、对比两个特效的开销、判断是不是某个脚本拖慢了页面,看它最直接。

网上流传最广的那个版本依赖 jQuery,实测在没有 jQuery 的页面上完全不显示。下面先放原版(已去掉原作者的署名注释),附上逐条实测数据,再给一份零依赖的修复版。

原版 · 实际效果

JSFPS 挂件 · 原版实际效果
// FPS 帧率显示
$('body').before('<div id="fps" style="z-index:10000;position:fixed;top:3;left:3;font-weight:bold;"></div>');
var showFPS = (function(){
  var requestAnimationFrame =
      window.requestAnimationFrame ||
      window.webkitRequestAnimationFrame ||
      window.mozRequestAnimationFrame ||
      window.oRequestAnimationFrame ||
      window.msRequestAnimationFrame ||
      function(callback){ window.setTimeout(callback, 1000/60); };
  var e,pe,pid,fps,last,offset,step,appendFps;
  fps = 0;
  last = Date.now();
  step = function(){
    offset = Date.now() - last;
    fps += 1;
    if( offset >= 1000 ){
      last += offset;
      appendFps(fps);
      fps = 0;
    }
    requestAnimationFrame( step );
  };
  appendFps = function(fps){
    console.log(fps+'FPS');
    $('#fps').html(fps+'FPS');
  };
  step();
})();

预览里那个数字始终不出现,不是代码没跑——是预览环境没有加载 jQuery,而原版第一行就用了 $。这正是它的第一个问题。

原版实测出的问题(测试环境:Chromium,视口 900×700):

① 没装 jQuery 就完全不显示

检查项 实测
页面未加载 jQuery 报错 $ is not defined
挂件节点数 0

整段代码从第一行就用 $,一报错后面全不执行。现在的主题大多不再默认加载 jQuery(WordPress 自带但前端不一定引入),粘上去大概率没反应。

② 挂件被插到了 body 外面

检查项 实测
原版写法 $('body').before(...)
挂件的父节点 HTML(正确应为 BODY)

before() 的含义是"插到 body 前面",于是这个 div 成了 <html> 的直接子元素,不在 body 里面。后果是:写在 body 上的字体、颜色、transform、overflow 全都影响不到它,document.body 相关的脚本也找不到它。

③ top:3;left:3 少了单位,等于没写

检查项 实测
原版写法 top:3;left:3
计算值 0px / 0px

CSS 里长度必须带单位,3 不是合法长度,整条声明被丢弃。所以那个 3px 的留白从来没生效过,数字一直紧贴屏幕边缘。

④ 深色页面上看不见

检查项 原版(页面背景 #14161c)
文字颜色 rgb(0, 0, 0)
背景颜色 rgba(0, 0, 0, 0)(透明)

原版只设了 font-weight:bold,没有 color 也没有 background——继承默认的黑字透明底。深色主题的页面上,这个数字等于隐形。

⑤ 切到后台再回来,会闪一个假的极低帧率

时间 原版显示
切后台前 61FPS
刚回到前台 31FPS
1.2 秒后 61FPS

切到后台时 requestAnimationFrame 会被浏览器暂停,回来第一帧的时间跨度是好几秒,可期间只累积了 1 帧——算出来就是个位数的帧率。原版没有重置逻辑,要等满一整秒才恢复正常。

⑥ 每秒往控制台打一行

观察时长 控制台输出
约 2.4 秒 2 行(62FPS、60FPS)

开着调试面板时刷屏,而且 console.log 本身有开销,测出来的帧率还会偏低一点。

⑦ 占用全局 id="fps"

id 是全局唯一的,fps 又是个很常见的词。一旦主题或其他插件也用了这个 id,$('#fps') 只会取到文档里的第一个,数字就跑到别人的元素上去了。

⑧ 关不掉

没有 remove、没有 hide,也没有开关。调试完想撤掉只能改模板;留在正式站点上,访客会一直看到这个数字。

修复版 · 零依赖 + 三档配色

HTMLFPS 挂件 · 零依赖修复版
<style>
.wxz-fps{
  position:fixed; left:6px; top:6px; z-index:9999;
  padding:3px 8px; border-radius:6px;
  font:600 12px/1.4 ui-monospace,Menlo,Consolas,monospace;
  color:#fff; background:rgba(28,30,38,.78);
  letter-spacing:.02em; cursor:default;
  user-select:none; -webkit-tap-highlight-color:transparent;
  transition:background-color .25s ease;
}
.wxz-fps.is-good{background:rgba(22,150,70,.88)}
.wxz-fps.is-mid {background:rgba(200,120,10,.90)}
.wxz-fps.is-bad {background:rgba(210,40,40,.90)}
@media (max-width:768px){ .wxz-fps{font-size:11px;padding:2px 7px} }
</style>

<div class="wxz-fps" title="双击关闭">-- FPS</div>

<script>
(function () {
  var CFG = { color:true, smooth:true, log:false };
  var el = document.querySelector('.wxz-fps');
  if (!el) return;
  var raf = window.requestAnimationFrame ||
            function (cb) { return setTimeout(function(){ cb(performance.now()); }, 16); };
  var frames = 0, last = performance.now(), shown = -1, hist = [], running = true;

  function paint(v) {
    el.textContent = v + ' FPS';
    if (CFG.log) console.log(v + 'FPS');
    if (!CFG.color) return;
    el.classList.remove('is-good', 'is-mid', 'is-bad');
    el.classList.add(v >= 55 ? 'is-good' : (v >= 30 ? 'is-mid' : 'is-bad'));
  }

  function tick(now) {
    if (!running) return;
    frames++;
    var dt = now - last;
    if (dt >= 500) {
      var v = Math.round(frames * 1000 / dt);
      frames = 0; last = now;
      if (CFG.smooth) {
        hist.push(v);
        if (hist.length > 4) hist.shift();
        v = Math.round(hist.reduce(function(a,b){return a+b;}, 0) / hist.length);
      }
      if (v !== shown) { shown = v; paint(v); }
    }
    raf(tick);
  }

  /* 切到后台时 rAF 会停,回来若不重置,会先显示一个假的极低帧率 */
  document.addEventListener('visibilitychange', function () {
    if (document.hidden) return;
    frames = 0; last = performance.now(); hist.length = 0;
  });

  el.addEventListener('dblclick', function () { el.style.display = 'none'; });

  window.wxzFps = {
    el: el,
    hide: function () { el.style.display = 'none'; },
    show: function () { el.style.display = ''; },
    stop: function () { running = false; el.remove(); }
  };

  raf(tick);
})();
</script>

改动都在细节上,外观从一行黑字变成了带底色的小徽标:

  • 去掉 jQuery 依赖:全程原生 JS,appendChild 挂到 body 内,任何站点都能跑。
  • 位置带单位:left:6px;top:6px,实测计算值 6px,留白是真的。
  • 加了底色和白字:深色半透明底 + 白色等宽字,浅色深色页面都看得清。
  • 三档配色:≥55 绿、30–54 橙、<30 红,扫一眼就知道卡不卡,不用读数字。
  • 后台回来先重置:监听 visibilitychange,回到前台立刻重新计数,实测不再出现 31FPS 那种假值。
  • 控制台输出默认关闭:CFG.log 改成 true 才会打印。
  • 不用全局 id:靠 .wxz-fps 类定位,页面上不留任何 id。
  • 更新更快也更稳:从 1 秒一次改成 0.5 秒一次 + 最近 4 次取平均,数字不再乱跳,卡顿也能更快看到。
  • 双击关闭,也留了接口:双击挂件即隐藏,window.wxzFps 还能 hide() / show() / stop()。
检查项 原版 修复版
无 jQuery 环境 报错,节点 0 正常显示
挂件父节点 HTML BODY
top / left 0px / 0px 6px / 6px
深色页面可读性 黑字透明底 白字 + 深色底
后台回来 闪 31FPS 稳定 58FPS
控制台输出 每秒 1 行 默认不输出
全局 id 占用 fps 无
关闭方式 无 双击 / 接口
手机上尺寸 — 55×19,溢出 0

怎么调

  • 换个角:改 CSS 里的 left:6px;top:6px。右下角就写 right:6px;bottom:6px,同时把 left、top 删掉——两个都留会以 left 为准(right 被忽略)。
  • 改配色阈值:JS 里 v >= 55 ? 'is-good' : (v >= 30 ? 'is-mid' : 'is-bad'),两个数字随便改。高刷屏(120Hz)建议把 55 提到 100。
  • 要控制台输出:CFG.log 改成 true。
  • 不要平滑平均:CFG.smooth 改成 false,数字跳动更明显,但瞬时卡顿更敏感。
  • 不要配色:CFG.color 改成 false,一直是深色底。
  • 临时隐藏:双击挂件;彻底移除用 wxzFps.stop(),会连循环一起停掉。
  • 怕挡住点击:挂件在左上角可能压住菜单按钮,给 .wxz-fps 加一行 pointer-events:none 即可(代价是双击关闭失效)。

为什么类名带 wxz- 前缀

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

像 .fps、#fps 这种名字,撞车概率非常高——主题、统计插件、性能面板都可能用。撞上之后后加载的覆盖先加载的,站上别的地方就莫名其妙变了样。

加上 wxz- 前缀后基本不会撞。所以:

  • 照抄时保留 wxz- 前缀,别图省事改回短名字。
  • 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效。
  • 这里没有用 id,就是为了不占全局命名空间。

改的时候注意这几点

  • 别依赖 jQuery:现在多数主题前端不加载它,用了等于白写。
  • 长度一定带单位:top:3 是无效的,必须 top:3px。
  • 别用 before() 挂到 body 外面:appendChild 到 body 才是对的。
  • 记得设 color 和 background:只加粗不加底色,深色主题上就看不见。
  • 切后台要重置计数:不然回来先闪一个假的低帧率。
  • 别用 z-index:10000:会浮在主题弹窗之上,999 就够。
  • 正式站点记得关掉:调试完用 wxzFps.stop() 或双击隐藏,别让访客看到调试数字。
  • 测的是当前页面:帧率跟设备性能、当时开的其他标签页都有关,换个机器数字会不一样。

怎么用

整段粘进页脚 HTML 代码区即可:

  • 博客园:后台 → 设置 → 页脚 HTML 代码。
  • WordPress:外观 → 小工具 → 页脚区加一个「自定义 HTML」,或者放进子主题的 footer.php。
  • Typecho / Hexo / Hugo:对应的页脚模板文件。

CSS、HTML、JS 三段是连在一起的一整块,粘的时候别拆开,也别重复粘贴——重复会出现两个挂件(虽然数字一样,但位置会叠在一起)。

只想在某几页看的话,把整段放进那几页的模板里,别放进全站页脚。

兼容性

requestAnimationFrame 全系支持,写法里已经带了 webkit / moz / ms 前缀和 setTimeout 兜底。classList、performance.now() 也都是老浏览器就有的。

visibilitychange 在很老的浏览器上不支持,只是"后台回来会闪一下",不影响使用。backdrop-filter 这里没用,避免了 Safari 的兼容坑。


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

作者:Flechazo

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

赞 (0)
悬挂挂件「回到顶部」:摇摆木牌 + 小狐狸,形象可换
上一篇 2026年11月1日 下午3:26
logo 扫光:一道白光定时扫过站点标志,纯 CSS 自动循环
下一篇 2026年11月2日 上午2:00

相关推荐

维 形 筑 网