W3cubDocs

/Web APIs

SVGAnimationElement: endEvent event

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The endEvent event of the SVGAnimationElement interface is fired when at the active end of the animation is reached.

Note: This event is not raised at the simple end of each animation repeat. This event may be raised both in the course of normal (i.e., scheduled or interactive) timeline play, as well as in the case that the element was ended with a DOM method.

This event is not cancelable and does not bubble.

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

addEventListener("endEvent", (event) => { })

onend = (event) => { }

Event type

A TimeEvent. Inherits from Event.

Event properties

TimeEvent.detail Read only: A long that specifies some detail information about the Event, depending on the type of the event. For this event type, indicates the repeat number for the animation.
TimeEvent.view Read only: A WindowProxy that identifies the Window from which the event was generated.

Examples

Animated circle

<svg xmlns="http://www.w3.org/2000/svg" width="300px" height="100px">
  <title>SVG SMIL Animate with Path</title>
  <circle cx="0" cy="50" r="50" fill="blue" stroke="black" stroke-width="1">
    <animateMotion path="M 0 0 H 300 Z" dur="5s" repeatCount="indefinite" />
  </circle>
</svg>

<hr />

<button>Stop animation</button>

<ul></ul>

ul {
  height: 100px;
  border: 1px solid #dddddd;
  overflow-y: scroll;
  padding: 10px 30px;
}

let svgElem = document.querySelector("svg");
let animateElem = document.querySelector("animateMotion");
let list = document.querySelector("ul");
let btn = document.querySelector("button");

animateElem.addEventListener("beginEvent", () => {
  let listItem = document.createElement("li");
  listItem.textContent = "beginEvent fired";
  list.appendChild(listItem);
});

animateElem.addEventListener("endEvent", () => {
  let listItem = document.createElement("li");
  listItem.textContent = "endEvent fired";
  list.appendChild(listItem);
});

animateElem.addEventListener("repeatEvent", (e) => {
  let listItem = document.createElement("li");
  let msg = "repeatEvent fired";
  if (e.detail) {
    msg += `; repeat number: ${e.detail}`;
  }
  listItem.textContent = msg;
  list.appendChild(listItem);
});

btn.addEventListener("click", () => {
  btn.disabled = true;
  animateElem.setAttribute("repeatCount", "1");
});

Event handler property equivalent

Note that you can also create an event listener for the end event using the onend event handler property:

animateElem.onend = () => {
  console.log("endEvent fired");
};

Specifications

Specification
Scalable Vector Graphics (SVG) 2> # EndEvent>

Browser compatibility

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`endEvent_event`	35 31–35 The `onend` event handler property is not supported.	79	93 6–93 The `onend` event handler property is not supported.	22 18–22 The `onend` event handler property is not supported.	10 The `onend` event handler property is not supported.	35 31–35 The `onend` event handler property is not supported.	93 6–93 The `onend` event handler property is not supported.	22 18–22 The `onend` event handler property is not supported.	10 The `onend` event handler property is not supported.	3.0 2.0–3.0 The `onend` event handler property is not supported.	37 4.4.3–37 The `onend` event handler property is not supported.	10 The `onend` event handler property is not supported.