VALUES Attribute | values Property

Sets or retrieves a list of values of an animation.


Scripting [ vValues = ] object.values [ = val ]

Possible Values

vValues Variant that specifies or receives a list of values. The values are semicolon delimited, and are applied over the course of the animation in the order they appear. This value can include any of the following length unit designators: px, in, cm, mm, pt, or pc. For more information about the supported length units, see CSS Length Units Reference.

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


The animation values must be legal values for the specified attributeName property. The values property overrides any specified to value, fromvalue, or by value set on the animation.

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 have made the change. 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 path property overrides any setting for the values property, the from property, the to property, or the by property.
  • The values property, if specified, overrides any setting for the from property, the to property, 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 script shows how to change an active animation from a path to a values list.


Standards Information

This property is defined in Synchronized Multimedia Integration Language (SMIL) 2.0 World Wide Web link.

Applies To


See Also

Introduction to HTML+TIME