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.