t:ANIMATEMOTION Element | animateMotion Object
This topic documents a feature of HTML+TIME 2.0, which is obsolete as of Windows Internet Explorer 9.
Animates the position of an element over time.
The following table lists the members exposed by the animateMotion object.Attributes/Properties
Attribute Property Description ACCELERATE accelerate
Sets or gets a value that applies an acceleration to an element timeline.
Sets or gets a value that indicates whether the animation is cumulative.
Sets or gets a value that indicates whether the animation is additive with other animations.
Sets or gets whether the timeline on an element begins playing in reverse immediately after it completes in the forward direction.
Sets or gets the delay time before the timeline begins playing on the element.
Sets or gets a relative offset value for an animation.
Sets or gets the interpolation mode for the animateMotion object.
Sets or gets a value that applies a deceleration to the end of a simple duration.
Sets or gets a value indicating the amount of time the element remains active or displayed.
Sets or gets a value indicating the end time for the element, or the end of the simple duration when the element is set to repeat.
Sets or gets the action taken by an element if the element timeline ends before the timeline on its parent element ends.
Sets or gets the starting value of an animation.
Gets a Boolean value that indicates whether the element is an Introduction to HTML+TIME media element.
Sets or gets a set of Bezier control points that define the interval pacing of an animation.
Sets or gets a list of time values used to control the pacing of an animation.
ORIGIN origin Sets or gets the origin of motion for the animation. PATH path
Sets or retrieves a set of values that describe a path as a function of time.
REPEATCOUNT repeatCount Sets or gets the number of times an element timeline repeats. REPEATDUR repeatDur
Sets or gets the number of seconds that an element timeline repeats.Sets or gets the number of seconds that an element timeline repeats.
Sets or gets the conditions under which an element can be restarted on a timeline.
Sets or gets the playback speed of an element relative to its parent time container.
Sets or gets whether the time container must synchronize playback to this element.
Gets the approximate bandwidth available to the system in bits-per-second.
Indicates whether to display a text equivalent of the audio portion of the presentation.
Indicates whether a given language is selected in a user's system preferences.
Specifies whether overdubs or subtitles render during a presentation.
Sets or gets the target element to be animated.
Sets or gets the type of timeline associated with an element.
Gets the parent time container element of the current element.
Sets or retrieves the ending value of an animation.
Sets or retrieves a list of values of an animation.Events
Event Property Description onbegin
Fires when the timeline starts on an element.
Fires when the timeline stops on an element.
Fires when the timeline on an element pauses.
Fires when the timeline repeats on an element, beginning with the second iteration.
Fires when an element's timeline resumes from a paused state.
Fires when the timeline on an element begins to play backward.Methods
Method Description activeTimeToParentTime
Converts a value in the element's active timeline to the corresponding point in the parent timeline.
Converts a value in the element's active timeline to the corresponding point in the segment timeline.
Starts the element on the timeline.
Starts an element's timeline at the specified time.
Converts a value in the document timeline to the corresponding point in the element's parent timeline.
Stops the element on the timeline.
Ends an element's timeline at the specified time.
Converts a value in the parent timeline to the corresponding point in the element's active timeline.
Converts a value in the element's parent timeline to the corresponding point in the document timeline.
Stops playing an element's timeline at the current point.
Removes any changes made to the element and returns the element to its original state.
Restarts the element's timeline from a paused state.
Locates a specified point on the element's active timeline and begins playing from that point.Locates a specified point on the element's active timeline and begins playing from that point.
Locates the specified point on the element's segment timeline, and begins playing from that point.
Locates a specified point on the element's segment timeline, including repetitions, and begins playing from that point.
Locates a specified frame in the object.
Converts a value in the element's segment timeline to the corresponding point in the element's active timeline.
Converts a value in the element's segment timeline to the corresponding point in the element's simple timeline.
Converts a value in the element's simple timeline to the corresponding point in the element's segment timeline.Objects
Object Description currTimeState
Contains information about an HTML+TIME timeline.
When animating style properties on an object, the property and any related properties must be initialized in the object's style. For example, when animating the top or left properties, you must initialize the top and left properties, as well as the position.
The following example demonstrates how to use the t:ANIMATEMOTION element to move a div.<HTML XMLNS:t ="urn:schemas-microsoft-com:time"> <HEAD> <TITLE>t:ANIMATEMOTION Demo</TITLE> <?IMPORT namespace="t" implementation="#default#time2"> </HEAD> <BODY> <DIV ID="oDIV" STYLE="position:absolute; top:100px; left:50px; width:100px; height:50px; border:solid black 1px; text-align:center;">Moving DIV!</DIV> <t:ANIMATEMOTION targetElement="oDIV" to="200,200" dur="5" fill="hold"/> </BODY> </HTML>
t:is used to associate this element with an XML namespace. You must declare the XML namespace in the html tag of your document when using this element.<HTML XMLNS:t ="urn:schemas-microsoft-com:time"><?IMPORT namespace="t" implementation="#default#time2"><t:ANIMATEMOTION TO="200,200" .../>
When writing script to dynamically change the properties of an active animation, developers should consider a couple of issues. Because results might be unpredictable or undefined when you change the properties of an active animation, restart the animation with beginElement after you have made the change. For example:<SCRIPT> object.endElement(); object.path="M 0 0 L 100 100"; object.beginElement(); </SCRIPT>
The members listed in the following table might not be accessible through scripting until the window. onload event fires. Waiting for this event to fire ensures that the document is completely loaded, that all behaviors have been applied to corresponding elements on the document , and that all the behavior's properties, methods, and events are available for scripting. Using any of the behavior-defined members before the window. onload event fires could result in a scripting error, indicating that the object does not support that particular member.
To change an active animation from a path to a values list through script:
- The path property overrides any setting for the values, from, to, or by properties.
- The values property, if specified, overrides any setting for the from, to, or by properties.
- The from property is used unless the values or path properties are specified.
- The to property, if specified, overrides any setting for the by property.
- The by property doesn't override any properties.<SCRIPT> object.endElement(); object.path=null; object.values="100,100;0,0"; object.beginElement(); </SCRIPT>
This element is not rendered.
This element requires a closing tag.