HTML - <tbody>
The HTML Table Body Element (<tbody>) defines one or more <tr>
element data-rows to be the body of its parent <table>
element (as long as no <tr> elements are immediate children of that table element.) In conjunction with a preceding <thead>
and/or <tfoot>
element, <tbody> provides additional semantic information for devices such as printers and displays. Of the parent table's child elements, <tbody> represents the content which, when longer than a page, will most likely differ for each page printed; while the content of <thead>
and <tfoot>
will be the same or similar for each page printed. For displays, <tbody> will enable separate scrolling of the <thead>
, <tfoot>
, and <caption>
elements of the same parent <table>
element. Note that unlike the <thead>, <tfoot>, and <caption> elements however, multiple <tbody> elements are permitted (if consecutive), allowing the data-rows in long tables to be divided into different sections, each separately formatted as needed.
Example
Please see the <table>
page for examples on <tbody>
.
Description
The HTML Table Body Element (<tbody>) defines one or more <tr>
element data-rows to be the body of its parent <table>
element (as long as no <tr> elements are immediate children of that table element.) In conjunction with a preceding <thead>
and/or <tfoot>
element, <tbody> provides additional semantic information for devices such as printers and displays. Of the parent table's child elements, <tbody> represents the content which, when longer than a page, will most likely differ for each page printed; while the content of <thead>
and <tfoot>
will be the same or similar for each page printed. For displays, <tbody> will enable separate scrolling of the <thead>
, <tfoot>
, and <caption>
elements of the same parent <table>
element. Note that unlike the <thead>, <tfoot>, and <caption> elements however, multiple <tbody> elements are permitted (if consecutive), allowing the data-rows in long tables to be divided into different sections, each separately formatted as needed.
Content categories | None. |
Permitted content | Zero or more <tr> elements. |
Tag omission | The <tbody> element is not a required child element for a parent <table> element to graphically render. However, it must not be present, if its parent <table> element has a <tr> element as a child. |
Permitted parent elements | Within the required parent <table> element, the <tbody> element can be added after a <caption> , <colgroup> , <thead> and a <tfoot> element. |
Normative document | HTML5, section 4.9.5 (HTML4.01, section 11.2.3) |
Attributes
Includes the Global Attributes.
Name | Version | Description | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
align |
HTML5 | This enumerated attribute specifies how horizontal alignment of each cell content will be handled. Possible values are:
If this attribute is not set, the left value is assumed. Note: Do not use this attribute as it is obsolete (not supported) in the latest standard.
|
||||||||||||||||||||||||||||||||
bgcolor |
This attribute defines the background color of each cell of the column. It is one of the 6-digit hexadecimal code as defined in sRGB, prefixed by a '#'. One of the sixteen predefined color strings may be used:
Usage note: Do not use this attribute, as it is non-standard and only implemented some versions of Microsoft Internet Explorer: the
<tbody> element should be styled using CSS. To give a similar effect to the bgcolor attribute, use the CSS property background-color , on the relevant <td> or <th> elements. |
|||||||||||||||||||||||||||||||||
char |
HTML5 | This attribute is used to set the character to align the cells in a column on. Typical values for this include a period (.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored.
Note: Do not use this attribute as it is obsolete (and not supported) in the latest standard. To achieve the same effect as the
char , in CSS3, you can use the character set using the char attribute as the value of the text-align property Unimplemented. |
||||||||||||||||||||||||||||||||
charoff |
HTML5 | This attribute is used to indicate the number of characters to offset the column data from the alignment characters specified by the char attribute.
Note: Do not use this attribute as it is obsolete (and not supported) in the latest standard.
|
||||||||||||||||||||||||||||||||
valign |
HTML5 | This attribute specifies the vertical alignment of the text within each row of cells of the table header. Possible values for this attribute are:
Note: Do not use this attribute as it is obsolete (and not supported) in the latest standard: instead set the CSS
vertical-align property on it. |
Browser Compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 1.0 | 1.0 (1.7 or earlier) | (Yes) | (Yes) | (Yes) |
align/valign attribute |
1.0 | Not supported [1] | (Yes) | (Yes) | (Yes) |
char/charoff attribute |
1.0 | Not supported [2] | (Yes) | (Yes) | (Yes) |
bgcolor attribute |
Not supported | Not supported | (Yes) | Not supported | Not supported |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | (Yes) | 1.0 (1.0) | (Yes) | (Yes) | (Yes) |
align/valign attribute |
? | Not supported [1] | ? | ? | ? |
char/charoff attribute |
? | Not supported [2] | ? | ? | ? |
bgcolor attribute |
Not supported | Not supported | (Yes) | Not supported | Not supported |
[1] See bug 915.
[2] See bug 2212.
See Also
- Other table-related HTML Elements:
<caption>
,<col>
,<colgroup>
,<table>
,<td>
,<tfoot>
,<th>
,<thead>
,<tr>
; - CSS properties and pseudo-classes that may be specially useful to style the <tbody> element:
- the
:nth-child
pseudo-class to set the alignment on the cells of the column; - the
text-align
property to align all cells content on the same character, like '.'.
- the
DOM interface
This element implements the HTMLTableSectionElement
interface.
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/html/element/tbody