tr element
If you don't know what an element is or how you must use it, I recommend you read the "HTML tags and attributes" tutorial that you can find in the HTML tutorials section.
Table of contents
Description
The tr
element represents a row in a table
. In HTML, tables are formed by a set of rows, each containing a number of cells. Therefore, this element is usually found holding one or more cells, that can be header cells (th
) or data cells (td
).
Examples
The following example represents a table
with a header (thead
) and a body (tbody
). The rows of this table, represented by the tr
element, are present in both containers described before and hold a number of three cells each.
<table class="default">
<thead>
<tr>
<th>Film</th>
<th>Gross</th>
<th>Year</th>
</tr>
</thead>
<tbody>
<tr>
<td>Avatar</td>
<td>$2,787,965,087</td>
<td>2009</td>
</tr>
<tr>
<td>Titanic</td>
<td>$2,186,772,302</td>
<td>1997</td>
</tr>
<tr>
<td>The avengers</td>
<td>$1,518,594,910</td>
<td>2012</td>
</tr>
</tbody>
</table>
Film | Gross | Year |
---|---|---|
Avatar | $2,787,965,087 | 2009 |
Titanic | $2,186,772,302 | 1997 |
The avengers | $1,518,594,910 | 2012 |
Now, we'll insert a table
without a tbody
. Here, the rows of the implicit body are declared as children of the table
itself and, as in the previous example, header rows are declared inside a thead
section. Note how the thead
section is properly preceding the rows of the implicit body.
<table class="default">
<thead>
<tr>
<th>Name</th>
<th>Estimated IQ</th>
</tr>
</thead>
<tr>
<td>Sir Isaac Newton</td>
<td>190</td>
</tr>
<tr>
<td>Leonardo da Vinci</td>
<td>180</td>
</tr>
<tr>
<td>Johannes Kepler</td>
<td>175</td>
</tr>
</table>
Name | Estimated IQ |
---|---|
Sir Isaac Newton | 190 |
Leonardo da Vinci | 180 |
Johannes Kepler | 175 |
Attributes
Specific attributes
align
The horizontal alignment of text in all the cells in the row. There are five possible values (case-insensitive):
- left: text is aligned to the left margin. This is the default value for data cells (
td
). - center: text is centered. This is the default value for header cells (
th
). - right: text is aligned to the right margin.
- justify: text is justified or aligned to both margins.
- char: text is aligned to a specific character. It's used together with the
char
attribute.
This attribute has become obsolete in HTML5 and, therefore, its use is no longer valid. Authors should replace it with style sheet declarations.
Example
<tr align="center">
char
A caracter that will act as axis for text alignment. It's meant to work together with the align
attribute when it has the "char" value. In other situations it will be completely ignored.
This attribute has become obsolete in HTML5 and its use is consequently invalid. Authors are adviced to replace it with style sheet declarations.
Example
<tr align="char" char="c">
charoff
An offset, from the first occurrence of the alignment caracter (specified in the char
attribute) and in the direction of the text. The resulting character of this calculation will be the axis for text alignment.
For this attribute to be considered, the align
attribute's value must be "char" and the char
attribute must be present.
This attribute is considered obsolete by HTML5 and its use is no longer recommended. Authors should drop its use in favor of style sheets.
Example
<tr align="char" char="t" charoff="7">
valign
The vertical alignment of the text in all the cells in the row. There are four possible values (case-insensitive):
- top: text is aligned to the top margin.
- middle: text is vertically centered.
- bottom: text is aligned to the bottom margin.
- baseline: all the cells in a row with this alignment should have their first text line on a common baseline.
This attribute is obsolete according to the HTML5 standard and, therefore, invalid. Authors are adviced to avoid its use and replace it with style sheet declarations.
Example
<tr valign="top">
bgcolor
A color to fill the background of the element.
The bgcolor
attribute has been removed from the HTML5 standard because of its presentational nature. Its results can be perfectly achieved with style sheets.
Example
<tr bgcolor="#00ccee">
Global attributes
For information about global attributes refer to this list of global attributes in HTML5.
Events
Global events
For information about global events refer to this list of global events in HTML5.