MDN self-hosted library · e01.org

`animation-iteration-count` CSS property

The animation-iteration-count CSS property sets the number of times an animation sequence should be played before stopping.

no runnable cells css-property upstream source

The animation-iteration-count CSS property sets the number of times an animation sequence should be played before stopping.

It is often convenient to use the shorthand property animation to set all animation properties at once.

CSS Demo: animation-iteration-count

```css interactive-example-choice animation-iteration-count: 0;


```css interactive-example-choice
animation-iteration-count: 2;

```css interactive-example-choice animation-iteration-count: 1.5;


```html interactive-example
<section class="flex-column" id="default-example">
  <div>Animation <span id="play-status"></span></div>
  <div id="example-element">Select a count to start!</div>
</section>

```css interactive-example

example-element {

align-items: center; background-color: #1766aa; border-radius: 50%; border: 5px solid #333333; color: white; display: flex; flex-direction: column; height: 150px; justify-content: center; margin: auto; margin-left: 0; width: 150px; }

play-status {

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%; } }


```js interactive-example
const el = document.getElementById("example-element");
const status = document.getElementById("play-status");

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();

Syntax

/* Keyword value */
animation-iteration-count: infinite;

/* <number> values */
animation-iteration-count: 3;
animation-iteration-count: 2.4;

/* Multiple values */
animation-iteration-count: 2, 0, infinite;

/* Global values */
animation-iteration-count: inherit;
animation-iteration-count: initial;
animation-iteration-count: revert;
animation-iteration-count: revert-layer;
animation-iteration-count: unset;

Values

This property is specified as one or more comma-separated values:

  • infinite
  • : The animation will repeat forever.
  • <number>
  • : The number of times the animation will repeat; this is 1 by default. You may specify non-integer values to play part of an animation cycle: for example, 0.5 will play half of the animation cycle. Negative values are invalid.

[!NOTE] When you specify multiple comma-separated values on an animation-* property, they are applied to the animations in the order in which the animation-names appear. For situations where the number of animations and animation-* property values do not match, see Setting multiple animation property values.

[!NOTE] When creating CSS scroll-driven animations, specifying an animation-iteration-count causes the animation to repeat that number of times over the course of the timeline's progression. If an animation-iteration-count is not provided, the animation will only occur once. infinite is a valid value for scroll-driven animations, but it results in an animation that doesn't work.

Formal definition

Formal syntax

Examples

Setting iteration count

This animation will run 10 times.

HTML

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

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);
  }
}

Result

Hover over the rectangle to start the animation.

100%

See CSS animations for examples.

Specifications

Browser compatibility

See also

  • Using CSS animations
  • JavaScript AnimationEvent API
  • Other related animation properties: animation, animation-composition, animation-delay, animation-direction, animation-duration, animation-fill-mode, animation-name, animation-play-state, animation-timeline, animation-timing-function