浏览器与 Web API / 系统课时

requestAnimationFrame 与动画更新

requestAnimationFrame 与动画更新

本课解决“动画能动但不够平滑、无法可靠停止”的问题。你将用 requestAnimationFrame 把更新交给浏览器帧循环,并用请求 ID、时间戳和显式状态控制开始、重复启动、取消与完成。

学习目标

  • 理解 requestAnimationFrame 与固定定时器在动画调度上的差异。
  • 使用时间戳计算进度,使动画速度不依赖设备帧率。
  • 正确保存、取消请求 ID,并避免重复动画和无效状态更新。

为什么动画更新要跟随渲染帧

requestAnimationFrame(callback) 会请求浏览器在下一次绘制前执行回调。它不是持续运行的循环:每次回调若还要继续动画,都必须再次调用。浏览器可根据屏幕刷新、页面可见性和系统负载安排时机,因此比固定间隔的 setInterval 更适合视觉更新。

回调参数是由浏览器提供的高精度时间戳。动画应根据“已经过去多少时间”计算位置,而不是假设每帧固定移动几个像素。这样即使某一帧延迟,动画仍能在预定时长附近完成,不会因帧率不同而忽快忽慢。

requestAnimationFrame 动画调度、重复请求与取消流程

完整示例:可开始、重启和取消的位移动画

下面的页面把方块在 1200 毫秒内移动 420 像素。再次点击“开始”会先取消旧动画;点击“取消”会停止后续帧;系统开启“减少动态效果”时,页面直接呈现终态,避免强制播放位移动画。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>requestAnimationFrame 示例</title>
  <style>
    .track { width: 470px; height: 56px; padding: 4px; background: #eef2f7; }
    .box { width: 48px; height: 48px; background: #2563eb; transform: translateX(0); }
    .controls { margin-top: 12px; }
  </style>
</head>
<body>
  <div class="track"><div id="box" class="box"></div></div>
  <div class="controls">
    <button id="start" type="button">开始</button>
    <button id="cancel" type="button">取消</button>
    <span id="status" aria-live="polite">等待开始</span>
  </div>

  <script>
    const box = document.querySelector("#box");
    const status = document.querySelector("#status");
    const startButton = document.querySelector("#start");
    const cancelButton = document.querySelector("#cancel");

    const duration = 1200;
    const distance = 420;

    // 两个变量共同描述当前动画生命周期。
    let requestId = null;
    let startTime = null;

    function stopAnimation(message) {
      if (requestId !== null) {
        cancelAnimationFrame(requestId);
        requestId = null;
      }
      startTime = null;
      status.textContent = message;
    }

    function step(timestamp) {
      startTime ??= timestamp;

      // 依据时间而不是帧数计算进度,避免不同刷新率造成速度差异。
      const progress = Math.min((timestamp - startTime) / duration, 1);
      box.style.transform = `translateX(${distance * progress}px)`;

      if (progress < 1) {
        requestId = requestAnimationFrame(step);
      } else {
        requestId = null;
        startTime = null;
        status.textContent = "动画完成";
      }
    }

    startButton.addEventListener("click", () => {
      stopAnimation("准备开始");
      box.style.transform = "translateX(0)";

      // 尊重用户的减少动态效果偏好,直接呈现终态。
      if (matchMedia("(prefers-reduced-motion: reduce)").matches) {
        box.style.transform = `translateX(${distance}px)`;
        status.textContent = "已按减少动态效果设置显示终态";
        return;
      }

      status.textContent = "动画进行中";
      requestId = requestAnimationFrame(step);
    });

    cancelButton.addEventListener("click", () => {
      stopAnimation("动画已取消");
    });
  </script>
</body>
</html>

预期结果

text
点击“开始”后,方块约 1.2 秒移动到轨道右侧,状态变为“动画完成”。
动画途中点击“取消”后,方块停在当前位置,状态变为“动画已取消”。
重复点击“开始”不会叠加多个帧循环,而是从起点重新开始。

状态控制的关键规则

请求 ID 代表尚未执行的那次帧请求,应保存在动画状态中。取消时调用 cancelAnimationFrame(requestId),随后把 ID 设为 null。即使回调已经开始执行,取消操作也只能阻止尚未执行的请求,因此回调内部仍要依据进度或业务状态决定是否继续安排下一帧。

动画更新应尽量只改变 transform、opacity 等合成友好的属性。若每帧同时读取布局尺寸并写入布局属性,容易触发反复计算。需要读写布局时,先集中读取,再集中写入;组件卸载、页面切换或动画失效时也要取消未完成请求。

常见边界与错误

  • 把 requestAnimationFrame 当作自动循环,只调用一次后没有再次安排下一帧。
  • 每帧固定增加位置,导致高刷新率设备更快、低刷新率设备更慢。
  • 重复点击开始时未取消旧请求,多个回调同时修改同一元素。
  • 只取消请求却不重置状态,下一次开始沿用旧的 startTime。
  • 忽略 prefers-reduced-motion,让不希望观看强动画的用户无法关闭效果。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

requestAnimationFrame 与动画更新

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通