The CSSValueList interface derives from the CSSValue interface and provides the abstraction of an ordered collection of CSS values.

Some properties allow an empty list in their syntax. In that case, these properties take the none identifier. So, an empty list means that the property has the value none.

The items in the CSSValueList are accessible via an integral index, starting from 0.


Inherits properties from its parent, CSSValue.

CSSValueList.length Read only
An unsigned long representing the number of CSSValues in the list.


This method is used to retrieve a CSSValue by ordinal index. The order in this collection represents the order of the values in the CSS style property. If index is greater than or equal to the number of values in the list, this returns null.


Specification Status Comment
Document Object Model (DOM) Level 2 Style Specification
The definition of 'CSSValuesList' in that specification.
Recommendation Initial definition

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support No support (Yes) ? No support ?
Feature Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ? (Yes) (Yes) ? ? ? ?

See also

Document Tags and Contributors

 Contributors to this page: Sebastianz
 Last updated by: Sebastianz,