HTML - <th>
The HTML element table header cell <th>
defines a cell as header of a group of table cells. The exact nature of this group is defined by the scope
and headers
attributes.
Example
See <table>
for examples on <th>
.
Description
The HTML element table header cell <th>
defines a cell as header of a group of table cells. The exact nature of this group is defined by the scope
and headers
attributes.
Content categories | None. |
Permitted content |
Phrasing content.
|
Tag omission | The start tag is mandatory. The end tag may be omitted, if it is immediately followed by a <th> or <td> element or if there are no more data in its parent element. |
Permitted parent elements | A <tr> element. |
Normative document | HTML5, section 4.9.10 (HTML4.01, section 11.2.6) |
Attributes
Includes the Global Attributes.
Name | Version | Description | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
abbr |
HTML5 | This attribute contains a short abbreviated description of the cell's content. A user-agent (e.g., a speech reader) may be present in front of the description.
Usage Note: Do not use this attribute as it has become obsolete in the latest standard. Alternatively, you can put the abbreviated description inside the cell and place the long content in the title attribute.
|
||||||||||||||||||||||||||||||||
align |
HTML 4 | This enumerated attribute specifies how the cell content's horizontal alignment will be handled. Possible values are:
The default value when this attribute is not specified is Usage Note: Do not use this attribute as it is obsolete in the latest standard.
|
||||||||||||||||||||||||||||||||
axis |
HTML5 | This attribute contains a list of space-separated strings. Each string is the id of a group of cells that this header applies to.
Usage Note: Do not use this attribute as it is obsolete in the latest standard: use the
scope attribute instead. |
||||||||||||||||||||||||||||||||
bgcolor |
This attribute defines the background color of each cell in a column. It consists of a 6-digit hexadecimal code as defined in sRGB and is prefixed by '#'. This attribute may be used with one of sixteen predefined color strings:
Usage note: Do not use this attribute, as it is non-standard and only implemented in some versions of Microsoft Internet Explorer: The
<th> element should be styled using CSS. To create a similar effec use the background-color property in CSS. |
|||||||||||||||||||||||||||||||||
char |
HTML 4 | The content of a column is aligned to a character in the <th> element . Typical values include a period (.) to align numbers or monetary values. If align is not set to char , this attribute is ignored.
Usage Note: Do not use this attribute as it is no longer supported by the latest standard. To achieve the same effect , you can specify the character as the first value of the
text-align property, Unimplemented in CSS3. |
||||||||||||||||||||||||||||||||
charoff |
HTML 4 | This attribute is used to shift column data to the right of the character specified by the char attribute. Its value specifies the length of this shift.
Usage Note: Do not use this attribute as it is no longer supported by the latest standard.
|
||||||||||||||||||||||||||||||||
colspan |
This attribute contains a positive integer value that indicates over how many columns a cell is extended. Its default value is 1. If its value is set to 0 , the cell is extended to the last element of the <colgroup> . Values higher than 1000 are clipped down to 1000. |
|||||||||||||||||||||||||||||||||
headers |
This attribute contains a list of space-separated strings, each corresponding to the id attributes of other <th> elements that relate to this element. |
|||||||||||||||||||||||||||||||||
rowspan |
This attribute contains a positive integer value that indicates over how many rows a cells is extended. Its default value is 1. If its value is set to 0 , the cell is extended to the last element of the table sections (<thead> , <tbody> or <tfoot> ). Values higher than 65534 are clipped down to 65534. |
|||||||||||||||||||||||||||||||||
scope |
This enumerated attribute defines the cells that the header (defined in the <th> ) element relates to. It may have the following values:
|
|||||||||||||||||||||||||||||||||
valign |
HTML 4 | This attribute specifies how a text is vertically aligned inside a cell. Possible values for this attribute are:
Usage Note: Do not use this attribute as it is no longer supported by the latest standard: use the CSS
vertical-align property instead. |
||||||||||||||||||||||||||||||||
width |
This attribute is used to define a recommended cell width. Additional space can be added with the cellspacing and cellpadding properties and the width of the <col> element can also create extra width. But, if a column's width is too narrow to show a particular cell properly, it will be widened when displayed.
Usage Note: Do not use this attribute in the latest standard: use the CSS
width property instead. |
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 | No support [1] | (Yes) | (Yes) | (Yes) |
char/charoff attribute |
1.0 | No support [2] | (Yes) | (Yes) | (Yes) |
bgcolor attribute |
No support | No support | (Yes) | No support | No support |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | (Yes) | 1.0 (1.0) | (Yes) | (Yes) | (Yes) |
align/valign attribute |
? | No support [1] | ? | ? | ? |
char/charoff attribute |
? | No support [2] | ? | ? | ? |
bgcolor attribute |
No support | No support | (Yes) | No support | No support |
[1] See bug 915.
[2] See bug 2212.
See Also
DOM interface
This element implements the HTMLTableHeaderCellElement
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/th