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

Animation.playState

· 52CE 我爱测

作为一个 Web Animations API 的属性,**`Animation.playState`** 能够返回并设置一个可枚举值来描述一个动画的回放状态。

Web Animations

作为一个 Web Animations API 的属性,Animation.playState 能够返回并设置一个可枚举值来描述一个动画的回放状态。

[!NOTE] 这个属性只对 CSS Animations 和 Transitions 可读。

值

  • idle
    • : 动画当前的时间是无法解析的,并且队列里没有处于等待执行的任务。
  • pending
    • : 动画将一直等到某些等待中的任务完成方会执行。
  • running
    • : 动画处于正在运行状态。
  • paused
    • : 动画中止,并且Animation.currentTime该项属性不会更新。
  • finished
    • : 动画已经达到某一临界点,并且Animation.currentTime该项属性不会更新。

实例

在Growing/Shrinking Alice Game这个例子中,玩家们可以凭Alice crying into a pool of tears结束游戏。出于性能原因,游戏里,眼泪只当可见之时才能运动。因此,这些泪滴必须在下面的情况下刚好暂停运动:

// 创建泪珠动画

tears.forEach(function (el) {
  el.animate(tearsFalling, {
    delay: getRandomMsRange(-1000, 1000), // 获取每一滴随机泪珠
    duration: getRandomMsRange(2000, 6000), // 获取每一滴随机泪珠
    iterations: Infinity,
    easing: "cubic-bezier(0.6, 0.04, 0.98, 0.335)",
  });
  el.playState = "paused";
});

// 结尾需要现出时播放眼泪降落动画

tears.forEach(function (el) {
  el.playState = "playing";
});

// 暂停并重置正在哭泣时的泪滴动画

tears.forEach(function (el) {
  el.playState = "paused";
  el.currentTime = 0;
});

规范

浏览器兼容性

参见

  • Web Animations API
  • Animation 获取更多可用来控制网页动画的方法和属性
  • Animation.play(), Animation.pause(), Animation.finish(),这些方法可以设置一个动画的 playState

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

资料来源与适用范围

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

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

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