大网数据广告活动
Web 标准与前端开发

Element.animate()

· 52CE 我爱测

Element 接口的 **`animate()`** 方法是创建一个新的 Animation 的便捷方法,将它应用于元素,然后运行动画。它将返回一个新建的 Animation 对象实例

Web Animations

Element 接口的 animate() 方法是创建一个新的 Animation 的便捷方法,将它应用于元素,然后运行动画。它将返回一个新建的 Animation 对象实例

[!NOTE] 一个元素上可以应用多个动画效果。你可以通过调用 Element.getAnimations() 函数获得这些动画效果的一个列表。

语法

animate(keyframes, options)

参数

  • keyframes
    • : 关键帧对象数组,或一个关键帧对象(其属性为可迭代值的数组)。参见关键帧格式以了解详细信息。
  • options
    • : 代表动画持续时间的整数(以毫秒为单位),或者一个包含一个或多个时间属性(在 KeyframeEffect() options 参数和下方列出)的对象:
      • id
        • : 在 animate() 里可作为唯一标识的属性:一个用来引用动画的字符串。

返回值

返回 Animation。

示例

旋转和缩放

在以下示例中,我们使用 animate() 方法旋转和缩放元素。

HTML

<div class="newspaper">翻报纸真的<br />会头晕</div>

CSS

html,
body {
  height: 100%;
}

body {
  display: flex;
  justify-content: center;
  align-items: center;
  background-color: black;
}

.newspaper {
  padding: 0.5rem;
  text-transform: uppercase;
  text-align: center;
  background-color: white;
  cursor: pointer;
}

JavaScript

const newspaperSpinning = [
  { transform: "rotate(0) scale(1)" },
  { transform: "rotate(360deg) scale(0)" },
];

const newspaperTiming = {
  duration: 2000,
  iterations: 1,
};

const newspaper = document.querySelector(".newspaper");

newspaper.addEventListener("click", () => {
  newspaper.animate(newspaperSpinning, newspaperTiming);
});

结果

旋转和缩放

Down the Rabbit Hole 演示

在演示 Down the Rabbit Hole (with the Web Animation API) 中,我们用 animate() 来快速创建并运行使 #tunnel 元素无限循环缓慢升起的动画。注意关键帧的对象数组和时间可选项。

document.getElementById("tunnel").animate(
  [
    // keyframes
    { transform: "translateY(0px)" },
    { transform: "translateY(-300px)" },
  ],
  {
    // timing options
    duration: 1000,
    iterations: Infinity,
  },
);

隐含关键帧

在新版的浏览器中,你可以只设置动画的开始或结束状态(即单个关键帧),如果可以,浏览器会自动推断动画的另一端(结束或开始)的状态。例如,考虑这个简单动画——关键帧对象如下所示:

let rotate360 = [{ transform: "rotate(360deg)" }];

我们仅指定了动画的结束状态,开始状态是隐含的。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。