The HTMLTableCellElement interface provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of table cells, either header cells (<th>)) or data cells (<td>), in an HTML document.
On this page
HTMLTableCellElement
Instance properties
Inherits properties from its parent, HTMLElement.
-
HTMLTableCellElement.abbr -
A string which can be used on
<th>elements (not on<td>), specifying an alternative label for the header cell. This alternate label can be used in other contexts, such as when describing the headers that apply to a data cell. This is used to offer a shorter term for use by screen readers in particular, and is a valuable accessibility tool. Usually the value ofabbris an abbreviation or acronym, but can be any text that's appropriate contextually. HTMLTableCellElement.cellIndexRead only-
A long integer representing the cell's position in the
cellscollection of the<tr>the cell is contained within. If the cell doesn't belong to a<tr>, it returns-1. -
HTMLTableCellElement.colSpan -
An unsigned long integer indicating the number of columns this cell must span; this lets the cell occupy space across multiple columns of the table. It reflects the
colspanattribute. HTMLTableCellElement.headersRead only-
A
DOMTokenListdescribing a list ofidof<th>elements that represents headers associated with the cell. It reflects theheadersattribute. -
HTMLTableCellElement.rowSpan -
An unsigned long integer indicating the number of rows this cell must span; this lets a cell occupy space across multiple rows of the table. It reflects the
rowspanattribute. -
HTMLTableCellElement.scope -
A string indicating the scope of a
<th>cell. Header cells can be configured, using thescopeproperty, the apply to a specified row or column, or to the not-yet-scoped cells within the current row group (that is, the same ancestor<thead>,<tbody>, or<tfoot>element). If no value is specified forscope, the header is not associated directly with cells in this way. Permitted values forscopeare:-
col -
The header cell applies to the following cells in the same column (or columns, if
colspanis used as well), until either the end of the column or another<th>in the column establishes a new scope. -
colgroup -
The header cell applies to all cells in the current column group that do not already have a scope applied to them. This value is only allowed if the cell is in a column group.
-
row -
The header cell applies to the following cells in the same row (or rows, if
rowspanis used as well), until either the end of the row or another<th>in the same row establishes a new scope. -
rowgroup -
The header cell applies to all cells in the current row group that do not already have a scope applied to them. This value is only allowed if the cell is in a row group.
- The empty string (
"") -
The header cell has no predefined scope; the user agent will establish the scope based on contextual clues.
-
Instance methods
No specific method; inherits methods from its parent, HTMLElement.
Deprecated properties
Warning: These properties have been deprecated and should no longer be used. They are documented primarily to help understand older code bases.
HTMLTableCellElement.alignDeprecated-
A string containing an enumerated value reflecting the
alignattribute. It indicates the alignment of the element's contents with respect to the surrounding context. The possible values are"left","right", and"center". HTMLTableCellElement.axisDeprecated-
A string containing a name grouping cells in virtual. It reflects the obsolete
axisattribute. HTMLTableCellElement.bgColorDeprecated-
A string containing the background color of the cells. It reflects the obsolete
bgColorattribute. HTMLTableCellElement.chDeprecated-
A string containing one single character. This character is the one to align all the cell of a column on. It reflects the
charand default to the decimal points associated with the language, e.g.'.'for English, or','for French. This property was optional and was not very well supported. HTMLTableCellElement.chOffDeprecated-
A string containing an integer indicating how many characters must be left at the right (for left-to-right scripts; or at the left for right-to-left scripts) of the character defined by
HTMLTableCellElement.ch. This property was optional and was not very well supported. HTMLTableCellElement.heightDeprecated-
A string containing a length of pixel of the hinted height of the cell. It reflects the obsolete
heightattribute. HTMLTableCellElement.noWrapDeprecated-
A boolean value reflecting the
nowrapattribute and indicating if cell content can be broken in several lines. HTMLTableCellElement.vAlignDeprecated-
A string representing an enumerated value indicating how the content of the cell must be vertically aligned. It reflects the
valignattribute and can have one of the following values:"top","middle","bottom", or"baseline". Use the CSSvertical-alignproperty instead. HTMLTableCellElement.widthDeprecated-
A string specifying the number of pixels wide the cell should be drawn, if possible. This property reflects the also obsolete
widthattribute. Use the CSSwidthproperty instead.
Specifications
| Specification |
|---|
| HTML Standard # htmltablecellelement |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
HTMLTableCellElement |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
abbr |
1 | 12 | 1 | 6 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
align |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
axis |
1 | 12 | 1 | 6 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
bgColor |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
cellIndex |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
ch |
1 | 12 | 1 | 6 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
chOff |
1 | 12 | 1 | 6 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
colSpan |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
headers |
1 | 12 | 1 | 6 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
height |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
noWrap |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
rowSpan |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
scope |
1 | 12 | 1 | 6 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
vAlign |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
width |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
See also
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableCellElement