Animation Timing Attributes¶
begin¶
begin = <begin-value-list>
Defines when the element should begin (i.e. become active).
The attribute value is a semicolon separated list of values.
dur¶
dur = <Clock-value> | 'media | indefinite'
Specifies the simple duration.
The attribute value can be one of the following:
value | description |
---|---|
<Clock-value> | Specifies the length of the simple duration in presentation time. Value must be greater than 0. |
media |
Specifies the simple duration as the intrinsic media duration.
This is only valid for elements that define media.(For SVG’s
animation elements, if 'media' is specified, the attribute
will be ignored.) |
indefinite |
Specifies the simple duration as indefinite. |
If the animation does not have a dur attribute, the simple duration is indefinite. Note that interpolation will not work if the simple duration is indefinite (although this may still be useful for set elements).
end¶
end = <end-value-list>
Defines an end value for the animation that can constrain the active duration.
The attribute value is a semicolon separated list of values.
A value of 'indefinite'
specifies that the end of the animation will be
determined by an endElement method call (the animation DOM methods are
described in DOM interfaces).
min¶
min = <Clock-value> | 'media'
Specifies the minimum value of the active duration.
value | description |
---|---|
<Clock-value> | Specifies the length of the minimum value of the active duration, measured in local time. Value must be greater than 0. |
'media' |
Specifies the minimum value of the active duration as the
intrinsic media duration. This is only valid for elements
that define media. (For SVG’s animation elements, if
'media' is specified, the attribute will be ignored.) |
The default value for min is '0'
. This does not constrain the active
duration at all.
max¶
max = <Clock-value> | 'media'
Specifies the maximum value of the active duration.
value | description |
---|---|
<Clock-value> | Specifies the length of the maximum value of the active duration, measured in local time. Value must be greater than 0. |
'media' |
Specifies the maximum value of the active duration as the
intrinsic media duration. This is only valid for elements
that define media. (For SVG’s animation elements, if
'media' is specified, the attribute will be ignored.) |
There is no default value for max. This does not constrain the active duration at all.
restart¶
restart = 'always | whenNotActive | never'
value | description |
---|---|
'always' |
The animation can be restarted at any time. This is the default value. |
'whenNotActive' |
The animation can only be restarted when it is not active (i.e. after the active end). Attempts to restart the animation during its active duration are ignored. |
'never' |
The element cannot be restarted for the remainder of the current simple duration of the parent time container. (In the case of SVG, since the parent time container is the SVG document fragment, then the animation cannot be restarted for the remainder of the document duration.) |
repeatCount¶
repeatCount = <number> | 'indefinite'
Specifies the number of iterations of the animation function. It can have the following attribute values:
value | description |
---|---|
<number> | This is a (base 10) “floating point” numeric value that specifies the number of iterations. It can include partial iterations expressed as fraction values. A fractional value describes a portion of the simple duration. Values must be greater than 0. |
'indefinite' |
The animation is defined to repeat indefinitely (i.e. until the document ends). |
repeatDur¶
repeatDur = <Clock-value> | 'indefinite'
Specifies the total duration for repeat. It can have the following attribute values:
value | description |
---|---|
<Clock-value> | Specifies the duration in presentation time to repeat the animation function f(t). |
'indefinite' |
The animation is defined to repeat indefinitely (i.e. until the document ends). |
fill¶
fill = 'freeze | remove'
This attribute can have the following values:
value | description |
---|---|
'freeze' |
The animation effect F(t) is defined to freeze the effect value at the last value of the active duration. The animation effect is “frozen” for the remainder of the document duration (or until the animation is restarted - see SMIL Animation: Restarting animation). |
'remove' |
The animation effect is removed (no longer applied) when the active duration of the animation is over. After the active end of the animation, the animation no longer affects the target (unless the animation is restarted - see SMIL Animation: Restarting animation). This is the default value. |