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.
Obsolete Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support No ? Yes — 62 ? No ?
length No ? Yes — 62 ? No ?
item No ? Yes — 62 ? No ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support ? ? ? Yes — 62 ? ? ?
length ? ? ? Yes — 62 ? ? ?
item ? ? ? Yes — 62 ? ? ?

See also

Document Tags and Contributors

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