Web/API/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.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/CSSValue" target="_top"><rect x="1" y="1" width="80" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="41" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">CSSValue</text></a><polyline points="81,25  91,20  91,30  81,25" stroke="#D4DDE4" fill="none"/><line x1="91" y1="25" x2="121" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/CSSValueList" target="_top"><rect x="121" y="1" width="120" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="181" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">CSSValueList</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Properties

Inherits properties from its parent, CSSValue.

CSSValueList.lengthRead 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 SpecificationThe definition of 'CSSValuesList' in that specification.	Obsolete	Initial definition

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`CSSValueList` Deprecated'	Chrome No support No	Edge No support No	Firefox No support 1 — 62	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android No support No	Firefox Android No support 4 — 62	Opera Android ?	Safari iOS ?	Samsung Internet Android No support No
`item` Deprecated'	Chrome No support No	Edge No support No	Firefox No support 1 — 62	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android No support No	Firefox Android No support 4 — 62	Opera Android ?	Safari iOS ?	Samsung Internet Android No support No
`length` Deprecated'	Chrome No support No	Edge No support No	Firefox No support 1 — 62	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android No support No	Firefox Android No support 4 — 62	Opera Android ?	Safari iOS ?	Samsung Internet Android No support No

Legend

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