CSSValueList

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.

Properties

Inherits properties from its parent, CSSValue.

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

Methods

CSSValueList.item()
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.

Specifications

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

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic support
Deprecated
Chrome No support NoEdge ? Firefox No support ? — 62IE ? Opera No support NoSafari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android No support ? — 62Opera Android ? Safari iOS ? Samsung Internet Android ?
length
Deprecated
Chrome No support NoEdge ? Firefox No support ? — 62IE ? Opera No support NoSafari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android No support ? — 62Opera Android ? Safari iOS ? Samsung Internet Android ?
item
Deprecated
Chrome No support NoEdge ? Firefox No support ? — 62IE ? Opera No support NoSafari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android No support ? — 62Opera Android ? Safari iOS ? Samsung Internet Android ?

Legend

No support  
No support
Compatibility unknown  
Compatibility unknown
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.

See also

Document Tags and Contributors

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