t:ANIMATECOLOR Element | animateColor Object

This topic documents a feature of HTML+TIME 2.0, which is obsolete as of Windows Internet Explorer 9.

Changes the color of an object over time.

Members Table

The following table lists the members exposed by the animateColor object.

Attribute Property Description
ACCELERATE accelerate

Sets or gets a value that applies an acceleration to an element timeline.

ACCUMULATE accumulate

Sets or gets a value that indicates whether the animation is cumulative.

ADDITIVE additive

Sets or gets a value that indicates whether the animation is additive with other animations.

ATTRIBUTENAME attributeName

Sets or gets the name of the element attribute to animate.

AUTOREVERSE autoReverse

Sets or gets whether the timeline on an element begins playing in reverse immediately after it completes in the forward direction.

BEGIN begin

Sets or gets the delay time before the timeline begins playing on the element.

BY by

Sets or gets a relative offset value for an animation.

BY by

Sets or gets a relative offset value by which to animate a color attribute or property with the t:ANIMATECOLOR element.

CALCMODE calcMode

Sets or gets the interpolation mode for the animation.

CALCMODE calcMode

Sets or gets the interpolation mode for a t:ANIMATECOLOR element.

DECELERATE decelerate

Sets or gets a value that applies a deceleration to the end of a simple duration.

DUR dur

Sets or gets a value indicating the amount of time the element remains active or displayed.

END end

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.

FILL fill

Sets or gets the action taken by an element if the element timeline ends before the timeline on its parent element ends.

FROM from

Sets or gets the starting value of an animation.

FROM from

Sets or gets the starting value of a color attribute or property animated by t:ANIMATECOLOR.

hasMedia

Gets a Boolean value that indicates whether the element is an Introduction to HTML+TIME media element.

KEYSPLINES keySplines

Sets or gets a set of Bezier control points that define the interval pacing of an animation.

KEYTIMES keyTimes

Sets or gets a list of time values used to control the pacing of an animation.

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.
RESTART restart

Sets or gets the conditions under which an element can be restarted on a timeline.

SPEED speed

Sets or gets the playback speed of an element relative to its parent time container.

SYNCMASTER syncMaster

Sets or gets whether the time container must synchronize playback to this element.

systemBitrate

Gets the approximate bandwidth available to the system in bits-per-second.

systemCaptions

Indicates whether to display a text equivalent of the audio portion of the presentation.

systemLanguage

Indicates whether a given language is selected in a user's system preferences.

systemOverdubOrSubtitle

Specifies whether overdubs or subtitles render during a presentation.

TARGETELEMENT targetElement

Sets or gets the target element to be animated.

TIMECONTAINER timeContainer

Sets or gets the type of timeline associated with an element.

timeParent

Gets the parent time container element of the current element.

TO to

Sets or retrieves the ending value of an animation.

TO to

Sets or retrieves the ending value of a color attribute or property animated by t:ANIMATECOLOR.

VALUES values

Sets or retrieves a list of values of an animation.

VALUES values

Sets or retrieves a list of RGB color values for a t:ANIMATECOLOR element.

Event Property Description
onbegin

Fires when the timeline starts on an element.

onend

Fires when the timeline stops on an element.

onpause

Fires when the timeline on an element pauses.

onrepeat

Fires when the timeline repeats on an element, beginning with the second iteration.

onreset

Fires when the timeline reaches the value of the BEGIN attribute or when the resetElement method is called on the element.

onresume

Fires when an element's timeline resumes from a paused state.

onreverse

Fires when the timeline on an element begins to play backward.

Method Description
activeTimeToParentTime

Converts a value in the element's active timeline to the corresponding point in the parent timeline.

activeTimeToSegmentTime

Converts a value in the element's active timeline to the corresponding point in the segment timeline.

beginElement

Starts the element on the timeline.

beginElementAt

Starts an element's timeline at the specified time.

documentTimeToParentTime

Converts a value in the document timeline to the corresponding point in the element's parent timeline.

endElement

Stops the element on the timeline.

endElementAt

Ends an element's timeline at the specified time.

parentTimeToActiveTime

Converts a value in the parent timeline to the corresponding point in the element's active timeline.

parentTimeToDocumentTime

Converts a value in the element's parent timeline to the corresponding point in the document timeline.

pauseElement

Stops playing an element's timeline at the current point.

resetElement

Removes any changes made to the element and returns the element to its original state.

resumeElement

Restarts the element's timeline from a paused state.

seekActiveTime

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.
seekSegmentTime

Locates the specified point on the element's segment timeline, and begins playing from that point.

seekTo

Locates a specified point on the element's segment timeline, including repetitions, and begins playing from that point.

seekToFrame

Locates a specified frame in the object.

segmentTimeToActiveTime

Converts a value in the element's segment timeline to the corresponding point in the element's active timeline.

segmentTimeToSimpleTime

Converts a value in the element's segment timeline to the corresponding point in the element's simple timeline.

simpleTimeToSegmentTime

Converts a value in the element's simple timeline to the corresponding point in the element's segment timeline.

Object Description
currTimeState

Contains information about an HTML+TIME timeline.

Remarks

When animating the color property on an object, the color must be initialized in the object's style. You must also set the attributeName to the specific color attribute you want to animate.

The following example demonstrates how to use the t:ANIMATECOLOR element to change the color of a div over time.

<HTML XMLNS:t ="urn:schemas-microsoft-com:time">
<HEAD>
  <TITLE>t:ANIMATECOLOR Demo</TITLE>
  <?IMPORT namespace="t" implementation="#default#time2">
</HEAD>

<BODY>

<DIV ID="oDIV" STYLE="width:100px; height:50px; background-color:red;
    text-align:center;">DIV!</DIV>

<t:ANIMATECOLOR targetElement="oDIV" attributeName="backgroundColor"
    to="yellow" start="2" dur="5" fill="hold">

</BODY>
</HTML>

The prefix 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">

You must then import the tag definitions from the time2 behavior by using the IMPORT processing instruction.

<?IMPORT namespace="t" implementation="#default#time2">

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 the animate, animateMotion, and animateColor objects, the time2 behavior uses the following model to evaluate which properties to animate.

  • 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.

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.

This element is not rendered.

This element requires a closing tag.

See Also

Introduction to HTML+TIME, animate, animateMotion, set, time2