---
name: "CSS::DOM::Value::List"
section: "3pm"
platform: "linux"
package: "libcss-dom-perl"
version: "0.17-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/CSS::DOM::Value::List"
---

# CSS::DOM::Value::List(3pm)

CSSValueList class for CSS::DOM

## NAME

CSS::DOM::Value::List - CSSValueList class for CSS::DOM

## VERSION

Version 0.17

## SYNOPSIS

```
  # ...
```

## DESCRIPTION

This module implements objects that represent CSS list property  values. It implements the DOM CSSValueList interface.

You can access the individual elements of the list using the `"item"` and `"length"` methods, or by using it as an array ref.

## METHODS

If you need the constructor, it's below the object methods. Normally you would get an object via CSS::DOM::Style's `"getPropertyCSSValue"` method.

### CSSValue Interface

- cssText

  Returns a string representation of the attribute. Pass an argument to set  it.

- cssValueType

  Returns `"CSS::DOM::Value::CSS_PRIMITIVE_VALUE"`.

### CSSValueList Interface

- item

  Returns the 'primitive' value at the given index.

- length

  Returns the number of values in the list.

### Constructor

You probably don't need to call this, but here it is anyway:

```
  $val = new CSS::DOM::Value::List:: %args;
```

The hash-style arguments are as follows. Only `"values"` is required.

- values

  This must be an array ref containing the individual values to be stored in the list. The individual elements can be value objects or array refs of arguments to pass to `"new CSS::DOM::Value::Primitive"`. E.g.,

  ```
   [
       [type => CSS_PX, value => 20],
       [type => CSS_PERCENTAGE, value => 50],
       [type => CSS_PERCENTAGE, value => 50],
       [type => CSS_PX, value => 50],
   ]
  ```

- css

  CSS code used for serialisation. This will make reading `"cssText"` faster at least until the value is modified.

- separator

  The value separator used in serialisation. This is usually ' ' or ', '. An empty string or `"undef"` is treated as a space.

- owner

  The style object that owns this value; if this is omitted, then the value is read-only. The value object holds a weak reference to the owner.

- property

  The name of the CSS property to which this value belongs. `"cssText"` uses this to determine how to parse text passed to it. This does not apply to the sub-values of colours, counters and rects, but it *does* apply to individual elements of a list value.

## SEE ALSO

CSS::DOM

CSS::DOM::Value

CSS::DOM::Value::Primitive

CSS::DOM::Style