TR object (Object/HTML)

An object that encapsulates the row content of a table contained in a <TR> tag.

Availability:

DOM level - 1
JavaScript - 1.5
JScript - 3.0
Internet Explorer - 4.0
Netscape - 6.0
Inherits from:Element object
JavaScript syntax:IEmyTR = myDocument.all.anElementID
IEmyTR = myDocument.all.tags("TR")[anIndex]
IEmyTR = myDocument.all[aName]
-myTR = myDocument.getElementById(anElementID)
-myTR = myDocument.getElementsByName(aName)[anIndex]
-myTR = myDocument.getElementsByTagName("TR")[anIndex]
HTML syntax:<TR> ... </TR>
Argument list:anIndexA reference to an element in a collection
aNameAn associative array reference
anElementIDThe ID value of an Element object
Object properties:align, bgColor, borderColor, borderColorDark, borderColorLight, ch, chOff, rowIndex, sectionRowIndex, vAlign
Object methods:deleteCell(), insertCell()
Event handlers:onBlur, onClick, onDblClick, onDragStart, onFilterChange, onHelp, onKeyDown, onKeyPress, onKeyUp, onMouseDown, onMouseMove, onMouseOut, onMouseOver, onMouseUp, onSelectStart
Collections:cells[]

Tables are a two dimensional array of cells divided first into rows and then into columns. To access a particular cell, you locate its row first and then index along the cells in a row to find the one you want.

Rows are enclosed in <TR> tags which instantiate a TR object. The TR objects in a table are available as members of the rows[] collection.

They are also available in the rows[] collections that belong to TFOOT, TBODY and THEAD objects if the rows have been grouped inside tags that instantiate those objects.

You can access the cells in a row by using the cells[] collection that belongs to the TR object for the row you are interested in.

Warnings:

See also:Element object, TABLE object, TABLE.deleteRow(), TABLE.insertRow(), TBODY object, TD object, TFOOT object, THEAD object

PropertyJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
align1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
bgColor1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
borderColor n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
borderColorDark n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
borderColorLight n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
ch1.5 1.5 n/a6.0 6.0 n/a n/a n/a n/a1 1 n/a n/a-
chOff1.5 1.5 n/a6.0 6.0 n/a n/a n/a n/a1 1 n/a n/a-
rowIndex1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/aReadOnly.
sectionRowIndex1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/aReadOnly.
vAlign1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-

MethodJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
deleteCell()1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
insertCell()1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-

Event nameJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
onBlur1.5 1.53.0 3.06.0 6.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aWarning
onClick1.5 1.53.0 3.06.0 6.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onDblClick1.5 1.53.0 3.06.0 6.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onDragStart n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onFilterChange n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onHelp n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aWarning
onKeyDown1.5 1.53.0 3.06.0 6.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyPress1.5 1.53.0 3.06.0 6.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyUp1.5 1.53.0 3.06.0 6.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseDown1.5 1.53.0 3.06.0 6.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseMove1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a n/a n/a4.0 4.0Warning
onMouseOut1.5 1.53.0 3.06.0 6.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseOver1.5 1.53.0 3.06.0 6.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseUp1.5 1.53.0 3.06.0 6.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onSelectStart n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-

Inheritance chain:

Element object, Node object