.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "CSS::DOM::Value::List 3pm"
.TH CSS::DOM::Value::List 3pm "2018-02-12" "perl v5.26.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
CSS::DOM::Value::List \- CSSValueList class for CSS::DOM
.SH "VERSION"
.IX Header "VERSION"
Version 0.17
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  # ...
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This module implements objects that represent \s-1CSS\s0 list property 
values. It
implements the \s-1DOM\s0 CSSValueList interface.
.PP
You can access the individual elements of the list using the \f(CW\*(C`item\*(C'\fR and
\&\f(CW\*(C`length\*(C'\fR methods, or by using it as an array ref.
.SH "METHODS"
.IX Header "METHODS"
If you need the constructor, it's below the object methods. Normally you
would get an object via CSS::DOM::Style's \f(CW\*(C`getPropertyCSSValue\*(C'\fR
method.
.SS "CSSValue Interface"
.IX Subsection "CSSValue Interface"
.IP "cssText" 4
.IX Item "cssText"
Returns a string representation of the attribute. Pass an argument to set 
it.
.IP "cssValueType" 4
.IX Item "cssValueType"
Returns \f(CW\*(C`CSS::DOM::Value::CSS_PRIMITIVE_VALUE\*(C'\fR.
.SS "CSSValueList Interface"
.IX Subsection "CSSValueList Interface"
.IP "item" 4
.IX Item "item"
Returns the 'primitive' value at the given index.
.IP "length" 4
.IX Item "length"
Returns the number of values in the list.
.SS "Constructor"
.IX Subsection "Constructor"
You probably don't need to call this, but here it is anyway:
.PP
.Vb 1
\&  $val = new CSS::DOM::Value::List:: %args;
.Ve
.PP
The hash-style arguments are as follows. Only \f(CW\*(C`values\*(C'\fR is
required.
.IP "values" 4
.IX Item "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 \f(CW\*(C`new CSS::DOM::Value::Primitive\*(C'\fR. E.g.,
.Sp
.Vb 6
\& [
\&     [type => CSS_PX, value => 20],
\&     [type => CSS_PERCENTAGE, value => 50],
\&     [type => CSS_PERCENTAGE, value => 50],
\&     [type => CSS_PX, value => 50],
\& ]
.Ve
.IP "css" 4
.IX Item "css"
\&\s-1CSS\s0 code used for serialisation. This will make reading \f(CW\*(C`cssText\*(C'\fR faster
at least until the value is modified.
.IP "separator" 4
.IX Item "separator"
The value separator used in serialisation. This is usually ' ' or
\&', '. An empty string or \f(CW\*(C`undef\*(C'\fR is treated as a space.
.IP "owner" 4
.IX Item "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.
.IP "property" 4
.IX Item "property"
The name of the \s-1CSS\s0 property to which this value belongs. \f(CW\*(C`cssText\*(C'\fR 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 \fIdoes\fR
apply to individual elements of a list value.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\s-1CSS::DOM\s0
.PP
CSS::DOM::Value
.PP
CSS::DOM::Value::Primitive
.PP
CSS::DOM::Style