1. 面向开发者的 Web 技术
  2. CSS:层叠样式表
  3. animation-iteration-count

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

animation-iteration-count

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年9月⁩.

animation-iteration-count CSS 属性设置动画序列在停止前应播放的次数

尝试一下

animation-iteration-count: 0;
animation-iteration-count: 2;
animation-iteration-count: 1.5;
<section class="flex-column" id="default-example">
 <div>Animation <span id="playstatus"></span></div>
 <div id="example-element">Select a count to start!</div>
</section>
#example-element {
 align-items: center;
 background-color: #1766aa;
 border-radius: 50%;
 border: 5px solid #333;
 color: white;
 display: flex;
 flex-direction: column;
 height: 150px;
 justify-content: center;
 margin: auto;
 margin-left: 0;
 width: 150px;
}
#playstatus {
 font-weight: bold;
}
.animating {
 animation-name: slide;
 animation-duration: 3s;
 animation-timing-function: ease-in;
}
@keyframes slide {
 from {
 background-color: orange;
 color: black;
 margin-left: 0;
 }
 to {
 background-color: orange;
 color: black;
 margin-left: 80%;
 }
}
"use strict";
window.addEventListener("load", () => {
 const el = document.getElementById("example-element");
 const status = document.getElementById("playstatus");
 function update() {
 status.textContent = "delaying";
 el.className = "";
 window.requestAnimationFrame(() => {
 window.requestAnimationFrame(() => {
 el.className = "animating";
 });
 });
 }
 el.addEventListener("animationstart", () => {
 status.textContent = "playing";
 });
 el.addEventListener("animationend", () => {
 status.textContent = "finished";
 });
 const observer = new MutationObserver(() => {
 update();
 });
 observer.observe(el, {
 attributes: true,
 attributeFilter: ["style"],
 });
 update();
});

使用动画的简写属性 animation 可以一次性设置所有动画属性,这通常非常方便。

语法

css
/* 关键字值 */
animation-iteration-count: infinite;
/* 数字值 */
animation-iteration-count: 3;
animation-iteration-count: 2.4;
/* 多个值 */
animation-iteration-count: 2, 0, infinite;
/* 全局值 */
animation-iteration-count: inherit;
animation-iteration-count: initial;
animation-iteration-count: revert;
animation-iteration-count: revert-layer;
animation-iteration-count: unset;

animation-iteration-count 属性可以指定一个或多个以逗号分隔的值。

infinite

无限循环播放动画。

<number>

动画重复的次数;默认为 1。你可以指定非整数值以播放动画循环的一部分:例如,0.5 将播放动画循环的一半。负值是无效的。

备注: 当你在 animation-* 属性上指定多个逗号分隔的值时,它们将按照 animation-name 出现的顺序应用于动画。对于动画数量和 animation-* 属性值不匹配的情况,请参见设置多个动画属性值

形式定义

初始值 1
适用元素all elements, ::before and ::after pseudo-elements
是否是继承属性
计算值 as specified
动画类型 Not animatable

形式语法

animation-iteration-count = 
<single-animation-iteration-count>#

<single-animation-iteration-count> =
infinite |
<number [0,∞]>

示例

设置迭代次数

该动画将会播放 10 次。

HTML

html
<div class="box"></div>

CSS

css
.box {
 background-color: rebeccapurple;
 border-radius: 10px;
 width: 100px;
 height: 100px;
}
.box:hover {
 animation-name: rotate;
 animation-duration: 0.7s;
 animation-iteration-count: 10;
}
@keyframes rotate {
 0% {
 transform: rotate(0);
 }
 100% {
 transform: rotate(360deg);
 }
}

结果

将鼠标悬停在矩形上来播放动画。

参见 CSS 动画示例。

规范

Specification
CSS Animations Level 1
# animation-iteration-count

浏览器兼容性

参见

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

AltStyle によって変換されたページ (->オリジナル) /