Permitted Context: TABLE
Content Model: Table Cells
(TH or TD)
The TR element acts as a container for a row of table cells defined
with the TH or TD elements. You can set default horizontal and vertical
alignment of cell contents for the row. You also have the ability to
disable word wrap for the row, and thereafter use the <BR> element
to determine line breaks and hence cell widths.
To assist with formatting tables to paged media, authors can
differentiate leading and trailing rows that are to be duplicated when
splitting tables across page boundaries. The recommended approach is to
subclass rows using the CLASS attribute For example:
<TABLE BORDER COLSPEC= ...>
<TR CLASS=Header> header cells ...
<TR CLASS=Body> body cells ...
<TR CLASS=Footer> footer cells ...
Paged browsers when splitting a table across a page boundary, can then
insert footer rows at the bottom of the current page and header rows at
the top of the next page, followed by the remaining body rows, and the
footer rows. This is repeated as necessary until all of the body rows
have been rendered. Refinements of this scheme can be devised by further
subclassing the rows together with an appropriate style sheet.
Permitted Attributes for the TR Element
- An SGML identifier used as the target for hypertext
links or for naming particular elements in associated style sheets.
Identifiers are NAME tokens and must be unique within the scope of
the current document.
- This is one of the ISO standard language abbreviations,
e.g. "en.uk" for the variation of English spoken in the United Kingdom.
It can be used by parsers to select language specific choices for
quotation marks, ligatures and hypenation rules etc. The language
attribute is composed from the two letter language code from ISO 639,
optionally followed by a period and a two letter country code from ISO
- This a space separated list of SGML NAME tokens and is
used to subclass tag names. By convention, the class names are
interpreted hierarchically, with the most general class on the left
and the most specific on the right, where classes are separated by a
period. The CLASS attribute is most commonly used to attach a
different style to some element, but it is recommended that where
practical class names should be picked on the basis of the element's
semantics, as this will permit other uses, such as restricting search
through documents by matching on element class names. The conventions
for choosing class names are outside the scope of this specification.
- The ALIGN attribute can be used to explicitly specify
the horizontal alignment of paragraphs within a table row:
- Paragraphs are rendered flush left.
- Paragraphs are centered.
- Paragraphs are rendered flush right.
- Text lines are justified where practical,
otherwise this gives the same effect as the align=left setting.
- Text lines are indented such that the first
occurrence of a decimal point on each line are aligned vertically. If a
line doesn't contain a decimal point, the line is rendered flush left
for data cells and centered for header cells.
Note: By default, header cells are centered while data cells
are flush left. This attribute can be used to alter these defaults on a row
by row basis. If you are specifying column alignments with the TABLE's
COLSPEC attribute, there is no point in also including an ALIGN attribute
with the TR element, as the latter will be ignored.
- This specifies the character to be used for the decimal
point with the ALIGN attribute, e.g. dp="." (the default) or dp=",".
The default may be altered by the language context, as set by the LANG
attribute on enclosing elements.
- The VALIGN attribute can be used to explicitly specify
the vertical alignment of material within a table row. It is overridden
by the VALIGN attribute on individual cells:
- The cell contents appear at the top of each cell
- Cell contents are centered vertically in each cell.
- The cell contents appear at the bottom of each
- This is used when you want to ensure that all
cells in the row share the same baseline. This constraint only applies
to the first text line for each cell.
- The NOWRAP attribute is used when you don't want the
browser to automatically wrap lines. You can then explicitly specify
line breaks in paragrphs using the BR element.