TO Attribute | to Property

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


Scripting [ vValue = ] [ = val ]

Possible Values

vValue Variant that specifies or receives the ending value of the animation.

The property is read/write. The property has no default value.


The by property cannot be used on the same element as the to property. If both properties are specified, the by value is ignored.

In the context of t:ANIMATECOLOR, valid attribute values are hexadecimal RGB values or the keywords that represent the values, for example, #8A2BE2 or blueviolet. For more information about supported color values, see the Color Table.

Setting the to property without also setting the from property can affect values set for the additive property. For more information, see the additive reference.

When writing script to dynamically change the properties of an active animation, results might be unpredictable or undefined. Restart the animation with beginElement after you change the properties. The following example shows how to use beginElement.


For the animate object, the animateMotion object, and the animateColor object, the time2 behavior uses the following model to evaluate which properties to animate.

  • The values property, if specified, overrides any setting for the from property, the to poperty, or the by property.
  • The from property is used, unless the values property or the path property is specified.
  • The to property, if specified, overrides any setting for the by property.
  • The by property doesn't override any properties.


The following example uses two t:ANIMATECOLOR elements to animate the backgroundColor of two DIV elements, outerDIV and innerDIV. The innerDIV begins with its backgroundColor set to yellow, which is animated to red over a five-second duration. The outerDIV is animated from red to yellow over the same duration.

The Show Me example provides several colored buttons. By clicking a button, you set the from attribute of the innerDIV animation element to that button's color value, and set the to attribute of the outerDIV animation element.

<HTML XMLNS:t ="urn:schemas-microsoft-com:time">
  .time {behavior: url(#default#time2);}
  <?IMPORT namespace="t" implementation="#default#time2">
    <t:PAR id="p1" begin="0" dur="15" fill="hold">
    <t:ANIMATECOLOR id="a1" attributeName="background-color" from="red" to="
    yellow" targetElement="outerDIV" begin="0" dur="5" fill="hold"/>
    <t:ANIMATECOLOR id="a2" attributeName="background-color" from="yellow" 
    to="red" targetElement="innerDIV" to="#0000FF" begin="0" dur="5" 

<DIV id="outerDIV" class="time" style="FONT-SIZE: 18px; LEFT: 118px; 
BORDER: black 1px solid; WIDTH: 279px; POSITION: absolute; TOP: 240px; 
HEIGHT: 217px; BACKGROUND-COLOR: red; TEXT-ALIGN: left; padding-left:3">

<DIV id="innerDIV" class="time" style="FONT-SIZE: 18px; LEFT: 162px; 
WIDTH: 188px; POSITION: absolute; TOP: 298px; HEIGHT: 98px; 
BACKGROUND-COLOR: yellow; TEXT-ALIGN: left; padding-left:3">innerDIV</DIV>

Applies To


See Also

Introduction to HTML+TIME, Color Table