日中杂记——requestAnimationFrame

window.requestAnimationFrame() 告诉浏览器——你希望执行一个动画，并且要求浏览器在下次重绘之前调用指定的回调函数更新动画。该方法需要传入一个回调函数作为参数，该回调函数会在浏览器下一次重绘之前执行

备注： 若你想在浏览器下次重绘之前继续更新下一帧动画，那么回调函数自身必须再次调用window.requestAnimationFrame()

当你准备更新动画时你应该调用此方法。这将使浏览器在下一次重绘之前调用你传入给该方法的动画函数 (即你的回调函数)。回调函数执行次数通常是每秒 60 次，但在大多数遵循 W3C 建议的浏览器中，回调函数执行次数通常与浏览器屏幕刷新次数相匹配。为了提高性能和电池寿命，因此在大多数浏览器里，当requestAnimationFrame() 运行在后台标签页或者隐藏的<iframe>里时，requestAnimationFrame() 会被暂停调用以提升性能和电池寿命。

回调函数会被传入DOMHighResTimeStamp参数，DOMHighResTimeStamp指示当前被 requestAnimationFrame() 排序的回调函数被触发的时间。在同一个帧中的多个回调函数，它们每一个都会接受到一个相同的时间戳，即使在计算上一个回调函数的工作负载期间已经消耗了一些时间。该时间戳是一个十进制数，单位毫秒，最小精度为 1ms(1000μs)。

警告： 请确保总是使用第一个参数 (或其它获得当前时间的方法) 计算每次调用之间的时间间隔，否则动画在高刷新率的屏幕中会运行得更快。

语法

window.requestAnimationFrame(callback);

参数：

• callback：下一次重绘之前更新动画帧所调用的函数 (即上面所说的回调函数)。该回调函数会被传入DOMHighResTimeStamp参数，该参数与performance.now()的返回值相同，它表示requestAnimationFrame() 开始去执行回调函数的时刻。

返回值：

• 一个 long 整数，请求 ID，是回调列表中唯一的标识。是个非零值，没别的意义。你可以传这个值给 window.cancelAnimationFrame() 以取消回调函数。

我们先来一个最简单的例子，在页面上有一个div，宽200px，高100px，现在要让它向右平移60px，可以这样实现：

<div id="some-element-you-want-to-animate"></div>

#some-element-you-want-to-animate {
  width: 200px;
  height: 100px;
  background-color: pink;
}

  const element = document.getElementById(
    'some-element-you-want-to-animate'
  ) as HTMLElement;

  let translateX = 0;

  function step() {
    translateX++;
    if (translateX > 60) {
      return;
    } else {
      element.style.transform = 'translateX(' + translateX + 'px)';
      element.innerText = String(translateX);
      window.requestAnimationFrame(step);
    }
  }

  window.requestAnimationFrame(step);

如果我想知道这段动画执行完毕，总共花了多长时间，可以修改代码如下：

  const element = document.getElementById(
    'some-element-you-want-to-animate'
  ) as HTMLElement;

  let translateX = 0;
  let start = 0;
  let end = 0;

  function step(timestamp: number) {
    if (translateX === 0) {
      start = timestamp;
    }
    translateX++;
    if (translateX > 60) {
      end = timestamp;
      element.innerText = String(end - start);
      return;
    } else {
      element.style.transform = 'translateX(' + translateX + 'px)';
      window.requestAnimationFrame(step);
    }
  }

  window.requestAnimationFrame(step);

我们可以看到，时间都在1秒左右。也就是说，这个函数的执行频率大约是每秒60次。

那如果我想修改执行频率，比如每秒只执行30次，那么可以查看如下代码：

  const element = document.getElementById(
    'some-element-you-want-to-animate'
  ) as HTMLElement;

  let translateX = 0;

  // 每秒执行30次，则执行1次需要的时间1/30(单位：秒)
  function step() {
    translateX++;
    if (translateX > 30) {
      return;
    } else {
      element.style.transform = 'translateX(' + translateX + 'px)';
      element.innerText = String(translateX);
      setTimeout(() => {
        window.requestAnimationFrame(step);
      }, (1 / 30) * 1000);
    }
  }

  window.requestAnimationFrame(step);

实现的方式有多种多样，大家可以多尝试。

canvas绘制函数曲线，这个用例就是使用requestAnimationFrame来执行动画的

相关链接

window.requestAnimationFrame