<?xml version="1.0" encoding="UTF-8"?>
<!-- the CSSValueList interface -->

<interface id="CSS-CSSValueList" name="CSSValueList"
  inherits="CSSValue" since="DOM Level 2">
  <descr>
    <p>The <code>CSSValueList</code> interface provides the abstraction of an
      ordered collection of CSS values.</p>
    <p>
      Some properties allow an empty list into their syntax. In that case,
      these properties take the <code>none</code> identifier. So, an empty list 
      means that the property has the value <code>none</code>.
    </p>
    <p>
      The items in the <code>CSSValueList</code> are accessible via an integral
      index, starting from 0.
    </p>
  </descr>
  <attribute id="CSS-CSSValueList-length" name="length" 
    type="unsigned long" readonly="yes">
    <descr>
      <p>The number of <code>CSSValues</code> in the list. The range of valid
	values of the indices is <code>0</code> to <code>length-1</code>
	inclusive.</p>
    </descr>
  </attribute>

  <method id="CSS-CSSValueList-item" name="item">
    <descr>
      <p>Used to retrieve a <code>CSSValue</code> 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 <code>null</code>.</p>
    </descr>
    <parameters>
      <param name="index" type="unsigned long" attr="in">
	<descr>
	  <p>Index into the collection.</p>
	</descr>
      </param>
    </parameters>
    <returns type="CSSValue">
      <descr>
	<p>The <code>CSSValue</code> at the <code>index</code> position in the
	  <code>CSSValueList</code>, or <code>null</code> if that is not a valid
	  index.</p>
      </descr>
    </returns>
    <raises>
      <!-- No exceptions -->
    </raises>
  </method>
</interface>
