DHTML Collections

---

Retrieves a collection of the OPTION objects in a SELECT object.

[ collOptions = ] select.options

[ oObject = ] select.options ( vIndex [ , iSubIndex ] )

collOptions	Reference to an array of elements contained by the object.
oObject	Reference to an individual item in the array of elements contained by the object.
vIndex	Required. Number or string specifying the element or collection to retrieve. If this parameter is a number, the method returns the element in the collection at the given position, where the first element has value 0, the second has 1, and so on. If this parameter is a string and there is more than one element with the name or id property equal to the string, the method returns a collection of matching elements.
iSubIndex	Optional. Position of an element to retrieve. This parameter is used when vIndex is a string. The method uses the string to construct a collection of all elements that have a name or id equal to the string and then retrieves from this collection the element at the position specified by iSubIndex.

To delete an option from a SELECT object, you assign the option a null value. This compresses the array.

If duplicate identifiers are found, a collection of those items is returned. Collections of duplicates must subsequently be referenced by ordinal position.

The following example displays the text and values of all OPTION objects in the first SELECT object in the document ( the select box in the members table of this page.

var coll = document.all.tags ( "SELECT" );
if ( coll.length > 0 ) {
   for ( i = 0; i < coll ( 0 ).options.length; i ++ )
      alert ( "Option " + i + " is " + coll ( 0 ).options ( i ).text + 
         "\n and has the value " + coll ( 0 ).options ( i ).value );
}

 Show me 

SELECT

multiple, selectedIndex, OPTION, selected, defaultSelected