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="/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="/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 longrepresenting the number ofCSSValuesin the list.
Methods
CSSValueList.item()- This method is used to retrieve a
CSSValueby 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 returnsnull.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Document Object Model (DOM) Level 2 Style Specification The definition of 'CSSValuesList' in that specification. |
Obsolete | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
CSSValueList | Chrome No support No | Edge No support No | Firefox No support 1 — 62 | IE ? | 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 | Chrome No support No | Edge No support No | Firefox No support 1 — 62 | IE ? | 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 | Chrome No support No | Edge No support No | Firefox No support 1 — 62 | IE ? | 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.