rows Collection (TABLE, TBODY, TFOOT, ...)

rows Collection

rows Collection

Retrieves a collection of tr (table row) objects from a table object.

Syntax

[ oColl = ] object.rows
[ oObject = ] object.rows(vIndex [, iSubIndex])

Possible Values

oColl Array of tr 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 rows object.

Attributes/Properties

Show:
Attributes/Properties
Methods

Property Description
length Sets or retrieves the number of objects in a collection.

Method Description
item Retrieves an object from the all collection or various other collections.
namedItem Retrieves an object or a collection from the specified 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

The scope of the rows collection is for the tHead, tBody, or tFoot object of the table. In addition, there is also a rows collection for the table object, which contains all the rows for the entire table. A row that appears in one of the table sections also appears in the rows collection for the table. The tr object has two index properties, rowIndex and sectionRowIndex, that indicate where a given row appears. The rowIndex property indicates where the tr appears with respect to the rows collection for the whole table. By contrast, sectionRowIndex returns where the tr appears with respect to the rows collection for the specific table section in which it is located.
If duplicate identifiers are found, a collection of those items is returned. Collections of duplicates must be referenced subsequently by ordinal position.

Example

This example shows how to use the rows and cells collections to insert a number into each cell of the table.

<HTML>
<![CDATA[<HTML
<SCRIPT type="text/javascript">
function numberCells()
{
	var count=1;
	var oTable = document.getElementById('oTable');
	var RowsLength = oTable.rows.length;
	for (var i=0; i < RowsLength; i++)
	{
	    var oCells = oTable.rows.item(i).cells;
	    var CellsLength = oCells.length;
	    for (var j=0; j < CellsLength; j++) 
	    {
		    oCells.item(j).innerHTML = count++;
	    }
	}
}
</SCRIPT>
<BODY >
<TABLE id=oTable border=1>
<TR><TH>&nbsp;</TH><TH>&nbsp;</TH><TH>&nbsp;</TH><TH>&nbsp;</TH></TR>
<TR><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD></TR>
<TR><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD><TD>&nbsp;</TD></TR>
</TABLE>
</BODY></HTML>

This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

This collection is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 .

Applies To

TABLE, TBODY, TFOOT, THEAD

Product Families

Resources

About Microsoft

Popular Places

Popular Searches

Popular Downloads

Microsoft Developer Network

oColl	Array of tr 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.

Tags: