TheHTMLTableCellElement interface provides special properties and methods (beyond the regularHTMLElement 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.

Instance properties

Inherits properties from its parent,HTMLElement.

HTMLTableCellElement.abbr

A string that 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 ofabbr is an abbreviation or acronym, but can be any text that's appropriate contextually.

HTMLTableCellElement.cellIndexRead only

A number representing the cell's position in thecells collection of the<tr> the cell is contained within. If the cell doesn't belong to a<tr>, it returns-1.

HTMLTableCellElement.colSpan

A positive number indicating the number of columns this cell must span; this lets the cell occupy space across multiple columns of the table. It reflects thecolspan attribute.

HTMLTableCellElement.headersRead only

ADOMTokenList describing a list ofid of<th> elements that represent headers associated with the cell. It reflects theheaders attribute.

HTMLTableCellElement.rowSpan

A positive number indicating the number of rows this cell must span; this lets a cell occupy space across multiple rows of the table. It reflects therowspan attribute.

HTMLTableCellElement.scope

A string indicating the scope of a<th> cell. Possible values forscope are:col,colgroup,row,rowgroup, or the empty string ("").

Instance methods

No specific method; inherits methods from its parent,HTMLElement.

Deprecated properties

HTMLTableCellElement.alignDeprecated

A string containing the value of thealign attribute, if present, or empty string if not set. It can be used to set the alignment of the element's contents to the surrounding context of"left","right", and"center". Use the CSStext-align property instead.

HTMLTableCellElement.axisDeprecated

A string containing a name grouping cells in virtual. It reflects the obsoleteaxis attribute.

HTMLTableCellElement.bgColorDeprecated

A string containing the background color of the cells. It reflects the obsoletebgColor attribute.

HTMLTableCellElement.chDeprecated

A string containing one single character. This character is the one to align all the cells of a column on. It reflects thechar and defaults 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 byHTMLTableCellElement.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 obsoleteheight attribute.

HTMLTableCellElement.noWrapDeprecated

A boolean value reflecting thenowrap attribute and indicating if cell content can be broken into several lines.

HTMLTableCellElement.vAlignDeprecated

A string representing an enumerated value indicating how the content of the cell must be vertically aligned. It reflects thevalign attribute and can have one of the following values:"top","middle","bottom", or"baseline". Use the CSSvertical-align property instead.

HTMLTableCellElement.widthDeprecated

A string specifying the number of pixels wide the cell should be drawn, if possible. This property reflects the also obsoletewidth attribute. Use the CSSwidth property instead.

Specifications

Browser compatibility

See also

• The HTML elements implementing this interface:<th> and<td>.