前言

介绍

基本使用

关键帧

KeyframeEffect的三种类的声明

keyframes

options

动画对象

全局Animation类

标签中的animate函数

总结

相关代码：

前言

接着上文往下介绍，上篇文章我们对JS原生动画和贝塞尔曲线有了一个详细的认识，基于定时器或动画帧，我们可以实现元素的动画缓动，本文将分享浏览器中功能强大的Animations API，有兴趣的朋友请接着往下看吧

介绍

Web Animations API（简称WAAPI）于2016年成为Web标准的一部分，它的功能比之前提到的动画要丰富的多，它的核心理念是时间轴和动画效果。它提供了一组功能强大的方法和属性，用于定义、操作和管理动画效果。

时间轴（Timeline）是WAAPI中的核心概念之一。它类似于一个全局时钟，用于管理和协调所有正在运行的动画。通过时间轴，开发者可以控制动画的播放、暂停、重置等操作。

动画效果（Animation Effect）指的是要应用到动画目标上的转换或变化。WAAPI提供了多种类型的动画效果，如位移（translate）、缩放（scale）、旋转（rotate）等。开发者可以使用这些效果来创建各种动画效果。

基本使用

关键帧

还记得之前的CSS关键帧吗？使用from to或者百分比来定义动画阶段的效果，在JS中使用KeyframeEffect类可以创建关键帧动画

const box = document.querySelector(".box")
const keyframes = [{ left: 0 },{ left: '100px' }
];
const keyframe = new KeyframeEffect(box, keyframes, 1000);

上述代码中，KeyframeEffect类接收三个参数：第一个是目标标签，第二个是关键帧，第三个是动画时间

KeyframeEffect的三种类的声明

KeyframeEffect(keyframeEffect)：复制关键帧配置
KeyframeEffect(element, keyframes, duration)：在标签element上生成新的动画，关键帧为keyframes，持续duration毫秒
KeyframeEffect(element, keyframes, options)：在标签element上生成新的动画，关键帧为keyframes，动画配置options

keyframes

关键帧的写法有两种，分别是数组的方式和样式对象的写法

数组

const keyframes = [{ left: 0, top: "50px" },{ left: '100px', top: "100px" },{ top: "150px" }
];

对象

const keyframes = {left: [0, '100px', '100px'], top: ["50px", "100px", "150px"]
}

options

KeyframeEffect的第三个参数类型是数字或options配置项，数字代表动画时长，options则有以下属性：

delay：动画开始之前的延迟时间，以毫秒为单位，默认值为0。对应css的animation-delay
direction：动画的播放方向，可以是 "normal"（正常播放）、"reverse"（反向播放）、"alternate"（交替播放）或 "alternate-reverse"（交替反向播放）。默认值为 "normal"。对应css的animation-direction
duration：动画的持续时间，以毫秒为单位，默认值为0。对应css的animation-duration
easing：动画的缓动函数，可以使用 CSS 缓动函数，如 "linear"、"ease"、"ease-in" 等，或者自定义的缓动函数。默认值为 "linear"。对应css的animation-timing-function
endDelay：动画结束后的延迟时间，以毫秒为单位，默认值为0。
fill：动画在非活动时间段的行为，可以是none（默认，动画结束后不会保留任何效果）、forwards（动画结束后保持最后一帧的效果）或backwards（动画开始前应用第一帧的效果）。也可以是both，表示同时应用forwards和backwards的效果。对应css的animation-fill-mode
iterationStart：动画的迭代开始位置，以小数表示（例如，0.5表示从动画的中间位置开始迭代），默认值为0。
iterations：动画的迭代次数，可以是一个正整数或Infinity（无限循环），默认值为1。对应css的animation-iteration-count
keyframes：动画的关键帧，可以是一个关键帧规则对象或关键帧数组。
playbackRate：用于控制动画播放速率的属性。它可以用于加速或减慢动画的播放速度。
composite（CompositeOperation）：动画的合成行为。可以是replace或add。默认值为replace。replace表示动画将覆盖目标属性的当前值，而add表示动画将与目标属性的当前值叠加。
iterationComposite（IterationCompositeOperation）：动画迭代之间的值合成行为。可以是replace或accumulate。默认值为replace。replace表示每次迭代时动画的值将替换目标属性的当前值，而accumulate表示每次迭代时动画的值将累积到目标属性的当前值上。
pseudoElement：应用动画的伪元素。可以是一个字符串，表示伪元素的名称，例如before或after，或者可以是null，表示应用于主元素而非伪元素。

示例

<!DOCTYPE html>
<html lang="CH"><head><meta charset="UTF-8" /><title>webAnimationsAPI</title><style>html,body {width: 100%;height: 100%;position: relative;}.box {width: 200px;height: 200px;top: 50px;position: absolute;background: lightblue;}.box::after {width: 100px;height: 100px;content: "";left: 50px;position: absolute;background: lightcoral;}</style>
</head><body><div class="box"></div><button onclick="playHandler()">开始</button><script>const box = document.querySelector(".box")const keyframes = [{ transform: "rotate(0)" },{ transform: "rotate(180deg)" },{ transform: "rotate(360deg)" },];const options = {delay: 500,// 延迟500毫秒开始动画duration: 1000,// 持续时间为1000毫秒easing: 'ease-in-out',// 缓动函数为ease-in-outiterations: Infinity,// 迭代3次direction: 'alternate',// 交替播放endDelay: 1000,// 延迟1000毫秒开始动画fill: "forwards",// 结束后保持最后一帧的效果iterationStart: .2,// 从动画的20%位置开始迭代composite: 'add',//使用add合成行为keyframes: keyframes,//指定关键帧playbackRate: 2.0,//播放速率为2倍iterationComposite: 'accumulate',//使用accumulate合成行为pseudoElement: '::after'//应用于after伪元素}const keyframe = new KeyframeEffect(box, keyframes, options);function playHandler() {const animation = new Animation(keyframe, document.timeline);animation.play();}</script>
</body></html>

效果

动画对象

全局Animation类

创建完成动画的关键帧后，我们可以使用全局的Animation类创建动画，动画的形式就是上面的关键帧

const box = document.querySelector(".box")
const keyframes = [{ left: 0, top: "50px" },{ left: '100px', top: "100px" },{ top: "150px" }
];
const keyframe = new KeyframeEffect(box, keyframes, 1000);
function playPauseHandler() {const animation = new Animation(keyframe);animation.play();
}

使用new Animation(keyframe)创建新的动画，然后使用play函数对动画进行激活

效果如下

Animation构造函数的参数有两个：关键帧对象AnimationEffect和时间线AnimationTimeline，前者就是上面说到的KeyframeEffect，AnimationTimeline一般可以使用document.timeline来描述

const animation = new Animation(keyframe, document.timeline);

animation对象中有许多属性和方法

属性

id：返回动画的唯一标识符。
startTime：动画开始的时间戳。
currentTime：当前动画的时间，以毫秒为单位。
playbackRate：动画的播放速率，默认值为1。
effect：动画的效果，KeyframeEffect对象。
timeline：动画所使用的时间轴，AnimationTimeline对象。
playState：动画的当前播放状态，可能的值为 "idle"、"pending"、"running"、"paused"、"finished"。
pending：动画的等待状态，即动画是否处于 pending 状态。

方法

play(): 播放动画。
pause(): 暂停动画。
cancel(): 取消动画。
finish(): 完成动画。
reverse(): 反转动画的播放方向。
updatePlaybackRate(playbackRate): 更新动画的播放速率。
addEventListener(type, listener): 在动画上添加事件监听器。如：finish（完成）、cancel（取消）和pause（暂停）等
removeEventListener(type, listener): 从动画上移除事件监听器。
oncancel: 一个事件处理程序，当动画被取消时执行。
onfinish: 一个事件处理程序，当动画完成时执行。

使用示例

<!DOCTYPE html>
<html lang="CH"><head><meta charset="UTF-8" /><title>webAnimationsAPI</title><style>html,body {width: 100%;height: 100%;position: relative;}.box {width: 200px;height: 200px;top: 50px;position: absolute;background: lightblue;}</style>
</head><body><div class="box"></div><button onclick="playHandler()">开始</button><button onclick="pauseHandler()">暂停</button><button onclick="cancelHandler()">取消、重置</button><button onclick="reverseHandler()">反向运行</button><button onclick="finishHandler()">完成动画</button><button onclick="playbackRateHandler()">更新动画速率</button><button onclick="playStateHandler()">获取状态</button><button onclick="currentTimeHandler()">获取时间轴位置</button><script>const box = document.querySelector(".box")const keyframes = [{ left: 0 },{ left: '300px' },];const keyframe = new KeyframeEffect(box, keyframes, {duration: 1000,iterations: Infinity,direction: 'alternate',fill: "forwards",});const animation = new Animation(keyframe, document.timeline);animation.addEventListener("finish", console.info)animation.addEventListener("cancel", console.info)animation.addEventListener("remove", console.info)function playHandler() {animation.play();}function pauseHandler() {animation.pause();}function cancelHandler() {animation.cancel();}function reverseHandler() {animation.reverse();}function finishHandler() {animation.finish();// 当iterations等于infinity时无法触发完成}function playStateHandler() {console.log(animation.playState);}function playbackRateHandler() {animation.updatePlaybackRate(2)}function currentTimeHandler() {console.log(animation.currentTime);}</script>
</body></html>

效果如下

标签中的animate函数

全局的Element标签对象继承于Animatable接口

该接口描述了两个方法：animate为当标签增加动画与getAnimations获取当前标签全部动画

interface Animatable {animate(keyframes: Keyframe[] | PropertyIndexedKeyframes | null, options?: number | KeyframeAnimationOptions): Animation;getAnimations(options?: GetAnimationsOptions): Animation[];
}

用法和KeyframeEffect+Animation类似

<!DOCTYPE html>
<html lang="CH"><head><meta charset="UTF-8" /><title>webAnimationsAPI</title><style>html,body {width: 100%;height: 100%;position: relative;}.box {width: 200px;height: 200px;top: 50px;position: absolute;background: lightblue;}</style>
</head><body><div class="box"></div><button onclick="playHandler()">开始</button><button onclick="pauseHandler()">暂停</button><script>const box = document.querySelector(".box")const keyframes = [{ left: 0 },{ left: '300px' },];const opts = {duration: 1000,iterations: Infinity,direction: 'alternate',fill: "forwards",}const animation = box.animate(keyframes, opts)function playHandler() {animation.play();}function pauseHandler() {animation.pause();}</script>
</body></html>