MDN wants to talk to developers like you: https://qsurvey.mozilla.com/s3/a3e7b5301fea

Using the Web Animations API

这篇翻译不完整。请帮忙从英语翻译这篇文章

web动画API可以让我们用JavaScript写动画并且控制动画。本文将通过有趣的demo和教学,以有趣的方式开启您对这片爱丽丝仙境的探索。

认识Web动画API

Web动画API将浏览器动画引擎向开发者打开,并由JavaScript进行操作。这些API被设计成 CSS Animations and CSS Transitions的接口,未来会对这些API做补充以丰富更多的功能。它是对网络上动画化的支持最有效的方式之一,让浏览器进行自己的内部,不需要hacks,或者强迫,或者Window.requestAnimationFrame()

通过Web动画API,我们可以将交互式动画从样式表移动到JavaScript,将表现与行为分开。 我们不再需要依赖DOM重的技术,如将CSS属性和范围类写入元素来控制播放方向。 与纯粹的声明式CSS不同,JavaScript还允许我们动态地将属性值设置为持续时间。 对于构建自定义动画库和创建交互式动画,Web动画API可能是完成工作的完美工具。 让我们看看它能做什么!

浏览器兼容情况

默认情况下,Firefox 48+和Chrome 36+中提供了本文中讨论的基本Web动画API功能。 Webkit和Edge已经将API移动到各自的待办事项列表中,但是直到我们看到所有浏览器都有完整的支持,所以有一个便于维护的polyfill( handy maintained polyfill)可以测试功能支持,并在必要时添加它。

用web动画API写css动画

学习Web动画API的更为熟悉的方法之一是从大多数网络开发人员开始使用以前的CSS动画。 CSS动画有一个熟悉的语法,很好地分解为演示目的。

The CSS version

这是一个用CSS写的滚动动画,显示爱丽丝落下通向仙境的兔子洞(see the full code on Codepen):

Alice Tumbling down the rabbit's hole.

请注意,背景移动,爱丽丝旋转,她的颜色变化偏离她的旋转。 我们将专注于本教程的爱丽丝。 这是控制爱丽丝动画的简化CSS:

#alice {
  animation: aliceTumbling infinite 3s linear;
}

@keyframes aliceTumbling {
  0% {
    color: #000;
    transform: rotate(0) translate3D(-50%, -50%, 0);    
  }
  30% {
    color: #431236;
  }
  100% {
    color: #000;
    transform: rotate(360deg) translate3D(-50%, -50%, 0);
  }
}

这样可以以恒定的(线性linear)速率在3秒内改变爱丽丝的颜色和变换的旋转,并无限循环。 在 @keyframes 块中,我们可以看到每个循环(约0.9秒)的30%,Alice的颜色从黑色变为深红色,然后在循环结束时再次返回。

Moving it to JavaScript

现在让我们尝试使用Web动画API创建相同的动画。

Representing keyframes

我们首先要做的是创建一个对应于我们的CSS @keyframes块的关键帧对象:

var aliceTumbling = [
  { transform: 'rotate(0) translate3D(-50%, -50%, 0)', color: '#000' },
  { color: '#431236', offset: 0.3},
  { transform: 'rotate(360deg) translate3D(-50%, -50%, 0)', color: '#000' }
];

这里我们使用一个包含多个对象的数组。 每个对象代表原始CSS中的一个键。 然而,与CSS不同,Web动画API不需要明确地告知每个键出现的动画的百分比。 它将根据您给出的按键数量自动将动画划分为相等的部分。 这意味着具有三个键的关键帧对象将通过动画的每个循环的方式播放中间键,除非另有说明。

当我们想要明确地设置一个键与其他键的偏移量时,我们可以直接在对象中指定一个偏移量,并与逗号分隔。 在上面的例子中,为了确保爱丽丝的颜色变化为30%而不是50%,我们给它的偏移量为0.3。

必须至少指定两个关键帧(表示动画序列的开始和结束状态).如果您的关键帧列表只有一个条目, Element.animate() 将抛出不支持的异常报错.

所以要回顾一下,除非你指定一个键上的偏移量,否则键的默认值是等间隔的。 方便吗?

表示时间属性

我们还需要创建一个定时属性的对象 (an AnimationEffectTimingProperties object) 对应于爱丽丝动画中的值:

var aliceTiming = {
  duration: 3000,
  iterations: Infinity
}

你会注意到这里有一些差异,如何在CSS中表示等价的值:

  • 一个,持续时间是毫秒,而不是秒 - 3000不是3秒.。像{domxref("WindowTimers.setTimeout()")}} 和{domxref("Window.requestAnimationFrame()")}}, Web动画API只支持毫秒。
  • The other thing you’ll notice is that it’s iterations, not iteration-count.

There are a number of small differences between the terminology used in CSS animations and the terminology used in Web Animations. For instance, Web Animations doesn't use the string "infinite", but instead uses the JavaScript keyword Infinity. And instead of timing-function we use easing. We aren’t listing an easing value here because, unlike CSS Animations where the default animation-timing-function is ease, in the Web Animations API the default easing is linear — which is what we want here.

整合这些特性

是时候把这些特性结合到一起运用了 Element.animate() :

document.getElementById("alice").animate(
  aliceTumbling,
  aliceTiming
)

And boom: the animation starts playing (see the finished version on Codepen).

可以在可以使用CSS动画化的任何DOM元素上调用animate()方法。 它可以用几种方式写成。 我们可以直接像这样传递他们的值,而不是为关键帧和时间属性制作对象:

document.getElementById("alice").animate(
  [
    { transform: 'rotate(0) translate3D(-50%, -50%, 0)', color: '#000' },
    { color: '#431236', offset: 0.3},
    { transform: 'rotate(360deg) translate3D(-50%, -50%, 0)', color: '#000' }
  ], {
    duration: 3000,
    iterations: Infinity
  }
);

更重要的是,如果我们只想指定动画的持续时间,而不是其迭代(默认动画迭代一次),我们可以单独传递毫秒:

document.getElementById("alice").animate(
  [
    { transform: 'rotate(0) translate3D(-50%, -50%, 0)', color: '#000' },
    { color: '#431236', offset: 0.3},
    { transform: 'rotate(360deg) translate3D(-50%, -50%, 0)', color: '#000' }
  ], 3000);

使用play(),pause(),reverse()和playbackRate控制播放

虽然我们可以使用Web动画API编写CSS动画,其中API真正派上用场的是操纵动画的播放。 Web动画API提供了一些控制播放的有用方法。 让我们来看看在Growing / Shrinking Alice游戏中暂停和播放动画(请查看Codepen的完整代码 full code on Codepen):

Playing the growing and shrinking game with Alice.

在这个游戏中,爱丽丝有一个动画,使她从小到大,我们通过一个瓶子和一个蛋糕控制。 这两个都有自己的动画。

暂停和启动动画

稍后我们会再讨论爱丽丝的动画,但现在我们来看看蛋糕的动画:

var nommingCake = document.getElementById('eat-me_sprite').animate(
[
  { transform: 'translateY(0)' },
  { transform: 'translateY(-80%)' }   
], {
  fill: 'forwards',
  easing: 'steps(4, end)',
  duration: aliceChange.effect.timing.duration / 2
});

Element.animate() 方法会在调用后立即执行。 为了防止蛋糕在用户有机会点击之前进食自己, 我们调用 Animation.pause() ,如下:

nommingCake.pause();

我们可以运行 Animation.play() 方法:

nommingCake.play();

特别地,我们想将其链接到爱丽丝的动画,所以当蛋糕被吃掉时,她变得更大。 我们可以通过以下功能来实现:

var growAlice = function() {

  // Play Alice's animation.
  aliceChange.play();

  // Play the cake's animation.
  nommingCake.play();

}

当用户握住鼠标或者在触摸屏上按住他们的手指在蛋糕上时,我们现在可以调用growAlice来使所有动画发挥作用:

cake.addEventListener("mousedown", growAlice, false);
cake.addEventListener("touchstart", growAlice, false);

其他有用的方法

除了暂停和播放,我们可以使用以下动画方法:

让我们先来看一下playbackRate - 一个否定的播放速度将导致一个动画反向运行。 当爱丽丝从瓶中喝酒时,她越来越小。 这是因为瓶子将动画的播放速度从1更改为-1:

var shrinkAlice = function() {
  aliceChange.playbackRate = -1;
  aliceChange.play();
}

bottle.addEventListener("mousedown", shrinkAlice, false);
bottle.addEventListener("touchstart", shrinkAlice, false);

Through the Looking-Glass,爱丽丝旅行到一个世界,她必须跑步留在原地 - 运行两倍快速前进! 在红女王比赛的例子中,爱丽丝和红女王正在跑步,留下来(查看Codepen上的全部代码full code on Codepen):

Alice and the Red Queen race to get to the next square in this game.

因为小孩子很容易轮胎,不像自动机棋子,爱丽丝不断减速。 我们已经通过在动画播放时设置了一个衰减代码:

setInterval( function() {

  // Make sure the playback rate never falls below .4
  if (redQueen_alice.playbackRate > .4) {
    redQueen_alice.playbackRate *= .9;    
  }

}, 3000);

但是通过点击或点击来敦促他们使他们通过乘以播放速度来加快速度:

var goFaster = function() {

  redQueen_alice.playbackRate *= 1.1;

}

document.addEventListener("click", goFaster);
document.addEventListener("touchstart", goFaster);

背景元素还具有播放时间,当您点击或点击时,它们会受到影响。 当Alice和Red Queen跑两倍的时候会发生什么? 当你让他们放慢时会发生什么?

获取动画信息

想象其他方式我们可以使用playbackRate,例如通过让他们减慢整个网站的动画来改善具有前庭障碍的用户的可访问性。 这不可能在CSS中重新计算每个CSS规则的持续时间,但是通过Web动画API,我们可以使用即将到来的(在浏览器中不支持!)document.getAnimations()方法 循环遍历页面上的每个动画,并将它们的播放速度减半:

document.getAnimations().forEach(
  function (animation) {
    animation.playbackRate *= .5;
  }
);

使用Web动画API,您需要更改的只是一个小的属性!

另一件与CSS动画有关的难点就是创建依赖于其他动画提供的值。 例如,在“成长和收缩爱丽丝”游戏的例子中,您可能会注意到蛋糕的持续时间有些奇怪:

duration: aliceChange.effect.timing.duration / 2

要了解这里发生了什么,让我们来看看Alice的动画:

var aliceChange = document.getElementById('alice').animate(
  [
    { transform: 'translate(-50%, -50%) scale(.5)' },
    { transform: 'translate(-50%, -50%) scale(2)' }   
  ], {
    duration: 8000,
    easing: 'ease-in-out',
    fill: 'both'
  });

爱丽丝的动画让她的尺寸从一半到8秒的两倍。 然后我们暂停她:

aliceChange.pause();

如果我们在动画开始时已经把她暂停了,那么她的全部尺寸将从一半开始,就像她已经把整个瓶子都喝完了一样! 我们想把动画的“播放头”放在中间,所以她已经中途了。 我们可以通过将她的 Animation.currentTime设置为4秒,如下所示:

aliceChange.currentTime = 4000;

但是在制作这个动画的时候,我们可能会改变爱丽丝的持续时间。 如果我们将动态时间设置为timeTime,那么它不会更好吗?所以我们一次不必再做两个更新? 我们实际上可以通过引用aliceChange的Animation.effect属性来实现,该属性返回一个包含Alice上所有效果细节的对象:

aliceChange.currentTime = aliceChange.effect.timing.duration / 2;

效果让我们访问动画的关键帧和时间对象 - aliceChange.effect.timing指向Alice的时间对象(其类型为AnimationEffectTimingReadOnly) - 这包含她的AnimationEffectTimingReadOnly.duration。 我们可以将她的持续时间分成两半,以获得她动画时间轴的中点,使她成为正常的高度。 现在,我们可以在任何一个方向扭转和播放动画,使她变小或变大!

当设置蛋糕和瓶子的持续时间时,我们可以做同样的事情:

var drinking = document.getElementById('liquid').animate(
[
  { height: '100%' },
  { height: '0' }   
], {
  fill: 'forwards',
  duration: aliceChange.effect.timing.duration / 2
});
drinking.pause();

现在,所有三个动画只有一个持续时间,我们可以从一个地方容易地改变。

我们还可以使用Web动画API来确定动画当前的时间。 当你用尽蛋糕吃或者清空瓶子时,游戏就结束了。 哪个角色扮演者取决于爱丽丝在她的动画中有多远,无论她是否变得太大,不能进入小门太小,无法达到打开门的钥匙。 我们可以弄清楚她是否在动画的大端或小端,让她的动画当前时间(currentTime)被她的activeDuration分成:

var endGame = function() {
  
  // get Alice's timeline's playhead location
  var alicePlayhead = aliceChange.currentTime;
  var aliceTimeline = aliceChange.effect.activeDuration;

  // stops Alice's and other animations
  stopPlayingAlice();

  // depending on which third it falls into
  var aliceHeight = alicePlayhead/aliceTimeline;

  if (aliceHeight <= .333){
    // Alice got smaller!
    ...

  } else if (aliceHeight >= .666) {
    // Alice got bigger!
    ...

  } else {
    // Alice didn't change significantly    
    ...

  }
}

Note: getAnimations() and effect are not fully supported as of this writing, but the polyfill does support them today.

Callbacks and promises

CSS动画和转换有自己的事件侦听器,这些也可以通过Web动画API:

  • onfinish is the event handler for the finish event and can be triggered manually with finish().
  • oncancel is the event handler for the cancel event and can be triggers with cancel().

在这里,我们为蛋糕,瓶子和爱丽丝设置回调来触发endGame功能:

// When the cake or runs out... 
nommingCake.onfinish = endGame;
drinking.onfinish = endGame;

// ...or Alice reaches the end of her animation
aliceChange.onfinish = endGame;

Prefer promises? The Web Animations API also specifies two promises: onfinish and oncancel.

These promises are not fully supported as of this writing.

结论

这些是Web动画API的基本功能,其中大部分功能已在最新版本的Firefox和Chrome中得到支持。 到目前为止,您应该准备好在浏览器中“跳下兔子洞”,动画制作动画实验! 如果您正在使用API并要共享,请尝试使用#WAAPI主题标签。 我们将会观看并且将编写更多的教程来涵盖更多的功能,支持传播!

See also

文档标签和贡献者

 此页面的贡献者: leeseean
 最后编辑者: leeseean,