dom / latest / svganimationelement / beginevent_event.html /

SVGAnimationElement: beginEvent event

The beginEvent event of the SVGAnimationElement interface is fired when the element local timeline begins to play. It will be raised each time the element begins the active duration (i.e., when it restarts, but not when it repeats).

It 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 begun 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('beginEvent', event => { });

onbegin = event => { };

Event type

Event properties

TimeEvent.detail Read only

Is 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

Is 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>

<ul>

</ul>
ul {
  height: 100px;
  border: 1px solid #ddd;
  overflow-y: scroll;
  padding: 10px 30px;
}
let svgElem = document.querySelector('svg');
let animateElem = document.querySelector('animateMotion');
let list = document.querySelector('ul');

animateElem.addEventListener('beginEvent', () => {
  let listItem = document.createElement('li');
  listItem.textContent = 'beginEvent 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);
})

Event handler property equivalent

Note that you can also create an event listener for the begin event using the onbegin event handler property:

animateElem.onbegin = () => {
  console.log('beginEvent fired');
}

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
beginEvent_event
35
The event handler is onbegin for this event.
31
The event handler, onbegin, is not supported.
79
The event handler is onbegin for this event.
93
The event handler is onbegin for this event.
6
The event handler, onbegin, is not supported.
No
22
The event handler is onbegin for this event.
18
The event handler, onbegin, is not supported.
10
The event handler, onbegin, is not supported.
37
The event handler is onbegin for this event.
4.4.3
The event handler, onbegin, is not supported.
35
The event handler is onbegin for this event.
31
The event handler, onbegin, is not supported.
93
The event handler is onbegin for this event.
6
The event handler, onbegin, is not supported.
22
The event handler is onbegin for this event.
18
The event handler, onbegin, is not supported.
10
The event handler, onbegin, is not supported.
3.0
The event handler is onbegin for this event.
2.0
The event handler, onbegin, is not supported.

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/SVGAnimationElement/beginEvent_event