Inherits from | Event |
Availability | Available in Safari 4.0 and later. Available in iPhone OS 2.0 and later. |
Companion guide |
WebKitAnimationEvent
objects encapsulate information about running animations.
Several animation related events are available through the DOM Event system. The start and end of an animation, and the end of each iteration of an animation all generate DOM events. An element can have multiple properties that are animated simultaneously. This simultaneous animation can occur either by setting a single -webkit-animation-name
value with keyframes containing multiple properties, or by setting multiple -webkit-animation-name
values. For the purposes of event dispatching, each CSS -webkit-animation-name
property specifies a single animation. Therefore, an event is sent for each -webkit-animation-name
property, not necessarily for each CSS property that is animated.
Each event contains the duration of the animation. This allows the event handler to determine the current iteration of a looping animation or the current position of an alternating animation. This duration does not include time the animation was in the paused play state.
The type
property of an animation event can have the following string values:
webkitAnimationStart
Occurs at the start of an animation. It can bubble and be canceled. Its animationName
property is set.
webkitAnimationEnd
Occurs when the animation finishes. It can bubble and be canceled. Its animationName
and elapsedTime
properties are set.
webkitAnimationIteration
Occurs at the end of each iteration of an animation when the -webkit-animation-iteration-count
is greater than 1
. It does not occur for animations with an iteration count of 1
. It can bubble and be canceled. Its animationName
and elapsedTime
properties are set.
The name of the animation. The value of the CSS -webkit-animation-name
property of the animation that caused the event.
readonly attribute DOMString animationName;
The duration of the animation, in seconds, since this event was sent, excluding any time the animation is paused. This value is not affected by the value of the CSS -webkit-animation-delay
property. If the type of the event is webkitAnimationStart
, elapsedTime
is 0
.
readonly attribute double elapsedTime;
Initializes a new animation event object.
voidinitWebKitAnimationEvent(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMString animationNameArg, in double elapsedTimeArg);
The type of event. See “Types of Animation Events” for possible values.
Determines whether the event can bubble. Pass true
if it can bubble; otherwise, false
.
Determines whether the event’s default action can be prevented. Pass true
if it can be prevented; otherwise, false
.
The name of the animation associated with this event.
The duration of the animation, in seconds, since the event was sent.
You use this method to initialize the value of a WebKitTransitionEvent
object that is created through the DocumentEvent
interface. This method can only be invoked before the WebKitTransitionEvent
object is dispatched via the dispatchEvent
method (although it can be invoked multiple times during that phase, if necessary). If it is invoked multiple times, the final invocation takes precedence.
Last updated: 2010-02-24