7 out of 14 rated this helpful - Rate this topic

elements Collection

Retrieves a collection, in source order, of all controls in a given form. input type=image objects are excluded from the collection.

Syntax

[ oColl = ] object .elements

[ oObject = ] object .elements( vIndex [, iSubIndex ] )

Possible Values

oColl Array of button, input, select, and textArea objects.

oObject Reference to an individual item in the array of elements contained by the object.

vIndex Required. Integer or string that specifies the element or collection to retrieve. If this parameter is an integer, 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 property equal to the string, and then retrieves from this collection the element at the position specified by iSubIndex.

Members Table

The following table lists the members exposed by the elements object.

Attributes/Properties

Property Description

constructor Returns a reference to the constructor of an object.

length Gets or sets the number of objects in a collection.

Methods

Method Description

item Retrieves a form object or an object from an elements collection.

namedItem Retrieves a form object or an object from an elements collection.

tags Retrieves a collection of objects that have the specified HTML tag name.

urns Retrieves a collection of all objects to which a specified behavior is attached.

Property	Description
constructor	Returns a reference to the constructor of an object.
length	Gets or sets the number of objects in a collection.

Method	Description
item	Retrieves a form object or an object from an elements collection.
namedItem	Retrieves a form object or an object from an elements collection.
tags	Retrieves a collection of objects that have the specified HTML tag name.
urns	Retrieves a collection of all objects to which a specified behavior is attached.

Remarks

This collection can contain any combination of the button, input, select, and textArea objects. For compatibility with existing Web content, however, input type=image objects are excluded.

A complete list of form controls is provided in the Introduction to Forms.

Standards Information

This collection is defined in DOM Level 1.

Applies To

FORM, HTMLFormElement Constructor

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ

FIELDSET elements as well

As of IE7, FIELDSET and OBJECT elements also enter the elements collection. FIELDSET elements cannot be located by name though.

History

11/26/2008
yecril

5/31/2009
yecril

oColl	Array of button, input, select, and textArea objects.
oObject	Reference to an individual item in the array of elements contained by the object.
vIndex	Required. Integer or string that specifies the element or collection to retrieve. If this parameter is an integer, 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 property equal to the string, and then retrieves from this collection the element at the position specified by iSubIndex.