为什么Animatic能在老浏览器流畅运行?前缀探测与时间戳修复内幕揭秘

原创2026-10-30 19:06:52566 阅读
文章标签:前端物理引擎

为什么Animatic能在老浏览器流畅运行?前缀探测与时间戳修复内幕揭秘

Animatic 是一款仅 7KB(gzip 后)的轻量级 CSS 动画引擎,能让上百个 DOM 对象同时流畅动画。它最"硬核"的功力不在 API 设计,而是一套针对老浏览器的兼容方案:前缀探测(自动识别厂商前缀)与时间戳修复(修正 requestAnimationFrame 帧时间戳的量级错乱)。这两处不到 30 行代码,就是 Animatic 能平稳跑在 IE10、老 Firefox 和老 Safari 上的秘密。

🧩 快速认识 Animatic:7KB 的 CSS 动画引擎

Animatic 提供两类运行模式,共用同一套动画描述:

  • JS 模式:在 requestAnimationFrame 帧循环中逐帧插值,由 src/world.js 与 src/timeline.js 驱动
  • CSS 模式:自动生成 @keyframes 规则注入样式表,交给浏览器 GPU 合成,实现见 src/css.js

完整入口可看 animatic.js,模块结构在 src/core.js 中导出。

💡 核心问题:老浏览器的 transform、animation、requestAnimationFrame 都带着各家前缀(-webkit-、-moz-、-ms-),且 rAF 回传的时间戳口径不一。Animatic 的解法集中在一个文件:src/utils.js。

🔍 内幕一:前缀探测——自动适配老浏览器

requestAnimationFrame 回退链

Animatic 加载时会依次尝试三种厂商前缀,拿到第一个存在的 API 就停止:

var requestAnimationFrame = root.requestAnimationFrame,
    vendors = ['moz', 'webkit', 'ms']

for (var i = 0; i < vendors.length && !requestAnimationFrame; i++) {
    requestAnimationFrame = root[vendors[i] + 'RequestAnimationFrame']

这段代码覆盖了三个时代:

前缀 对应浏览器
无前缀 现代标准浏览器
moz 旧版 Firefox
webkit 旧版 Safari / Chrome
ms IE10

注意细节:cancelAnimationFrame 有两种历史写法,回退链做了双保险(src/utils.js):

cancelAnimationFrame = root[vendors[i] + 'CancelAnimationFrame']
                    || root[vendors[i] + 'CancelRequestAnimationFrame']

从计算样式里"抠"出 CSS 前缀

JS API 有回退链,CSS 属性怎么探测?Animatic 用了一个非常轻的招数:读取页面根元素的 getComputedStyle,把所有属性名拼成一个字符串,再用正则找 -xxx-transform(src/utils.js):

var prefix = ([].slice.call(getComputedStyle(document.documentElement, null))
    	.join('').match(/(-(moz|webkit|ms)-)transform/) || [])[1],
    transformProperty = getProperty('transform'),
    animationProperty = getProperty('animation')

transform 是当年各家都强制加前缀的"风向标"属性——只要浏览器在计算样式里暴露了 -webkit-transform,就说明它认这个前缀。探测结果通过 getProperty(name) 统一分发:

function getProperty(name) {
    return prefix ? prefix + name : name
}

前缀在下游的三处落点

探测到前缀后,Animatic 在三个关键位置自动"翻译"属性名:

  1. 写样式:Item.style() 中 style<a href="https://link.gitcode.com/i/307fa3fa7c7d7e44e9b81e5a0b3bb062" target="_blank">transformProperty] = this.transform()([src/item.js),老浏览器自动写成 -webkit-transform
  2. 读回变换:CSS.stop() 解析 computed<a href="https://link.gitcode.com/i/7704d75a34a457e63f1285a4dff74069" target="_blank">transformProperty] 矩阵以接管动画([src/css.js)
  3. 生成 keyframes:CSS 模式下输出 @-webkit-keyframes / @keyframes,见 src/css.js:
var rule = ['@' + getProperty('keyframes') + ' ' + name + '{']

也就是说,开发者只写标准属性名,Animatic 在运行时决定"说哪种方言"。这正是 CHANGELOG.md 中 0.2.0 版本"cross-browser support"和"MS Internet Explorer 10 support"的底层支撑。

⏱️ 内幕二:时间戳修复——一行代码解决帧时间戳错乱

前缀问题只占一半。更隐蔽的坑是:requestAnimationFrame 回调里的时间戳,在不同浏览器里口径完全不同。

同一参数的两种量级

rAF 的帧时间戳只有两种可能:

  • 纪元毫秒(Date.now() 口径):约 1.7×10¹²,是个 13 位大数
  • 页面加载后毫秒(performance.now() 口径):从 0 开始递增,通常是个小数字

如果 Animatic 直接拿回调参数 tick 去算动画进度,而暂停/恢复逻辑却用 performance.now(),两套量级相减就会得到负数或天文数字——动画要么原地不动,要么瞬间跳完。

1e12 阈值:判断量级的巧妙技巧

Animatic 在启动时请求了一帧"探针",用一个阈值判断两种时钟是否同口径(src/utils.js):

requestAnimationFrame(function(tick) {
    fixTick = tick > 1e12 != performance.now() > 1e12
})

拆解一下这个表达式:

  • tick > 1e12:回调参数是纪元毫秒吗?
  • performance.now() > 1e12:高性能时钟是纪元毫秒吗?(现代浏览器都是"小数字",只有降级到 Date 时才是"大数字")
  • 两者布尔结果不一致(!=)→ 说明回调参数和内部时钟口径不同 → fixTick = true

这里还有个降级细节(src/utils.js):没有 performance.now() 的极老浏览器会回退到 Date:

var performance = root.performance && root.performance.now ? root.performance : Date

帧循环里的"换道"

fixTick 标记一旦置位,两个帧循环入口都会在每帧开头用内部时钟替换回调参数:

function update(tick) {
    if (fixTick) {
        tick = performance.now()
    }
    ...
}

修复后,无论浏览器回传什么口径的时间戳,Animatic 内部的 tick 永远与 performance.now() 同量级,插值计算从此稳定。

🎬 时间戳的下游:play、pause、seek 全靠它

口径统一后,暂停/恢复/跳转这些"依赖时间差"的 API 才能算得准:

CSS 模式下的动画暂停/接管也依赖同一套时钟(src/animations/css_animation.js)。如果没有时间戳修复,这些"差值运算"在口径不一致的浏览器上会全部失效。

📌 小结:30 行代码撑起跨浏览器底座

兼容难点 Animatic 的解法 位置
rAF API 前缀差异 moz/webkit/ms 回退链 src/utils.js
CSS 属性前缀差异 计算样式正则探测 transform src/utils.js
keyframes 前缀差异 getProperty('keyframes') 生成 src/css.js
帧时间戳口径不一 1e12 阈值探针 + 帧内换道 src/utils.js

对做兼容的老项目来说,这套思路值得抄作业:

  1. 运行时探测优于 UA 判断——查浏览器特性本身,而不是浏览器名字
  2. 一个"风向标"属性探测整族前缀——transform 加前缀的浏览器,其他属性基本也会
  3. 用阈值探针归一化时钟——一次探测,全局换道,下游逻辑无需感知差异

这也是 Animatic 能在 gzip 后仅 7KB 的体积下,同时服务 JS 逐帧插值和 CSS @keyframes 两种模式、并兼容 IE10 时代浏览器的根本原因。想动手验证,可以直接运行 example/timeline.html、example/bounce.html 等示例页面。

登录后查看全文
animatic