<TR>NN all IE all HTML all  

<TR>...</TR>

HTML End Tag: Optional  

A tr element is a container for one row of cells. Each cell within a row may be a th or td element. Every row requires at least a start tag to instruct the browser to begin rendering succeeding cell elements on the next line of the table. Other special-purpose row groupings available are the tfoot and thead, as well as the more generic tbody grouping element.

 
Example
  
<TABLE cols="3">
<THEAD>
<TR>
<TH>Time</TH><TH>Event</TH><TH>Location</TH>
</TR>
</THEAD>
<TBODY>
<TR>
<TD>7:30am-5:00pm</TD><TD>Registration Open</TD><TD>Main Lobby</TD>
</TR>
<TR>
<TD>9:00am-12:00pm</TD><TD>Keynote Speakers</TD><TD>Cypress Room</TD>
</TR>
</TBODY>
</TABLE>
 
Object Model Reference
  
[window.]document.getElementById(elementID)
 
Element-Specific Attributes
 
alignbackgroundbgcolorbordercolorbordercolordark
bordercolorlightchcharcharoffchoff
heightvalignwidth
 
Element-Specific Event Handler Attributes

None.
alignNN 6 IE 4 HTML 4  

align="alignConstant"

Optional  

Establishes the horizontal alignment characteristics of content within the row.

 
Example
  
<TR align="center">
 
Value

HTML 4 and various browsers implement different sets of attribute values.

The values center, left, and right are self-explanatory. The value justify spaces multiline content so that text is justified down both left and right edges. For the value char, the char attribute must also be set to specify the character on which alignment revolves. In the HTML 4 specification example, content that does not contain the character appears to be right-aligned to the location of the character in other rows of the same column.

It is important to bear in mind that the align attribute applies to every cell within the tr element, including any th element you specify for the table. If you want a different alignment for the row header, override the setting with a separate align attribute or text-align style sheet attribute for the tr or individual th elements.

 
Default

center
 
Object Model Reference
  
[window.]document.getElementById(elementID).align
backgroundNN 4 IE n/a HTML n/a  

background="URL"

Optional  

Specifies an image file that is used as a backdrop to the entire row of cells. Unlike normal images that get loaded into browser content, a background image loads in its original size (without scaling) and tiles to fill the available cell space. Smaller images download faster but are obviously repeated more often in the background. Navigator 4, however, requires a minimum image size of 16 by 16 pixels. Animated GIFs are also allowable, but very distracting to the reader. When selecting a background image, be sure it is very muted in comparison to the main content so that the content stands out clearly. Background images, if used at all, should be extremely subtle.

 
Example
  
<TR background="watermark.jpg">
 
Value

Any valid URL to an image file, including complete and relative URLs.
 
Default

None.
 
Object Model Reference
  
[window.]document.getElementById(elementID).background
bgcolorNN 3 IE 4 HTML 4  

bgcolor="colorTripletOrName"

Optional  

Establishes a fill color (behind the text and other content) for the cells contained by the tr element.

 
Example
  
<TR bgcolor="lavender">
 
Value

A hexadecimal triplet or plain-language color name. A setting of empty is interpreted as "#000000" (black). See Appendix A for acceptable plain-language color names.

 
Default

Varies with browser, browser version, and operating system.
 
Object Model Reference
  
[window.]document.getElementById(elementID).bgColor
bordercolorNN n/a IE 3 HTML n/a  

bordercolor="colorTripletOrName"

Optional  

The color used to render some of the pixels that create the illusion of borders around cells and the entire table. Internet Explorer applies the color to all four lines that make up the interior border of a cell. Therefore, colors of adjacent cells do not collide.

 
Example
  
<TR bordercolor="green">
 
Value

A hexadecimal triplet or plain-language color name. A setting of empty is interpreted as "#000000" (black). See Appendix A for acceptable plain-language color names.

 
Default

Varies with browser and operating system.
 
Object Model Reference
  
[window.]document.getElementById(elementID).borderColor
bordercolordark, bordercolorlightNN n/a IE 3 HTML n/a  

bordercolordark="colorTripletOrName" bordercolorlight="colorTripletOrName"

Optional  

The 3-D effect of table borders in Internet Explorer is created by careful positioning of light and dark lines around the page's background or default color (see Figure 8-4 in the table element discussion). You can independently control the colors used for the dark and light lines by assigning values to the bordercolordark (left and top edges of the cell) and bordercolorlight (right and bottom edges) attributes.

Typically, you should assign complementary colors to the pair of attributes. There is also no rule that says you must assign a dark color to bordercolordark. The attributes merely control a well-defined set of lines so you can predict which lines of the border change with each attribute.

 
Example
  
<TR bordercolordark="darkred" bordercolorlight="salmon">
 
Value

A hexadecimal triplet or plain-language color name. A setting of empty is interpreted as "#000000" (black). See Appendix A for acceptable plain-language color names.

 
Default

Varies with operating system.
 
Object Model Reference
  
[window.]document.getElementById(elementID).borderColorDark
[window.]document.getElementById(elementID).borderColorLight
charNN 6 IE n/a HTML 4  

char="character"

Optional  

The char attribute defines the text character used as an alignment point for text within a cell contained by the tr element. This attribute is of value only for the align attribute set to "char". Microsoft documents a ch attribute, which corresponds to the standards-based char attribute. In any case, the browser does not respond to either attribute. Netscape 7 has not yet connected support for the char attribute.

 
Example
  
<TR align="char" char=".">
 
Value

Any single text character.
 
Default

None.

charoffNN n/a IE n/a HTML 4  

charoff="length"

Optional  

The charoff attribute lets you set a specific offset point at which the character specified by the char attribute is to appear within a cell contained by the tr element. This attribute is provided in case the browser default positioning does not meet with the design goals of the table. Microsoft documents a choff attribute, which corresponds to the standards-based charoff attribute. In any case, the browser does not respond to either attribute. Netscape 7 has not yet connected support for the charoff attribute.

 
Example
  
<TR align="char" char="." charoff="80%">
 
Value

Any length value in pixels or percentage of cell space.
 
Default

None.
choff  

  

See charoff.

langNN 3 IE 4 HTML 4  

lang="languageCode"

Optional  

The language being used for the element's attribute values and content. A browser can use this information to assist in proper rendering of content with respect to details such as treatment of ligatures (when supported by a particular font or required by a written language), quotation marks, and hyphenation. Other applications and search engines might use this information to aid the selection of spell-checking dictionaries and the creation of indices.

 
Example
  
<SPAN lang="de">Deutsche Bundesbahn</SPAN>
 
Value

Case-insensitive language code.
 
Default

Browser default.
 
Object Model Reference
  
[window.]document.getElementById(elementID).lang
valignNN 6 IE 4 HTML 4  

valign="alignmentConstant"

Optional  

Determines the vertical alignment of content within cells of the column(s) covered by the tr element. You can override the vertical alignment for a particular cell anywhere in the row.

 
Example
  
<TR valign="bottom">
 
Value

Four constant values: top | middle | bottom | baseline. With top and bottom, the content is rendered flush (or very close to it) to the top and bottom of the table cell. Set to middle (the default), the content floats perfectly centered vertically in the cell. When one cell's contents might wrap to multiple lines at common window widths (assuming a variable table width), it is advisable to set the valign attribute to baseline. This assures that the character baseline of the first (or only) line of a cell's text aligns with the other cells in the rowusually the most aesthetically pleasing arrangement.

 
Default

middle
 
Object Model Reference
  
[window.]document.getElementById(elementID).vAlign