HTMLTableCellElement

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 or data cells, in an HTML document.

Properties

Inherits properties from its parent, HTMLElement.

HTMLTableCellElement.abbr

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

HTMLTableCellElement.cellIndex Read only

A long integer representing the cell's position in the cells collection 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 colspan attribute.

HTMLTableCellElement.headers Read only

Is a DOMSettableTokenList describing a list of id of <th> elements that represents headers associated with the cell. It reflects the headers attribute.

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 rowspan attribute.

HTMLTableCellElement.scope

A DOMString indicating the scope of a <th> cell. Header cells can be configured, using the scope property, 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 for scope, the header is not associated directly with cells in this way. Permitted values for scope are:

col

The header cell applies to the following cells in the same column (or columns, if colspan is 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 rowspan is 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.

Methods

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

Deprecated properties

These properties have been deprecated and should no longer be used. They are documented primarily to help understand older code bases.

HTMLTableCellElement.align

A DOMString containing an enumerated value reflecting the align attribute. It indicates the alignment of the element's contents with respect to the surrounding context. The possible values are "left", "right", and "center".

HTMLTableCellElement.axis

A DOMString containing a name grouping cells in virtual. It reflects the obsolete axis attribute.

HTMLTableCellElement.bgColor

A DOMString containing the background color of the cells. It reflects the obsolete bgcolor attribute.

HTMLTableCellElement.ch

A DOMString containing one single chararcter. This character is the one to align all the cell of a column on. It reflects the char and 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.chOff

A DOMString containing a 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.height

A DOMString containing a length of pixel of the hinted height of the cell. It reflects the obsolete height attribute.

HTMLTableCellElement.noWrap

A Boolean value reflecting the nowrap attribute and indicating if cell content can be broken in several lines.

HTMLTableCellElement.vAlign

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

HTMLTableCellElement.width

A DOMString specifying the number of pixels wide the cell should be drawn, if possible. This property reflects the also obsolete width attribute. Use the CSS width property instead.

Specifications

Browser compatibility

See also

• The HTML elements implementing this interface: <th> and <td> by inheritance via HTMLTableHeaderCellElement and HTMLTableDataCellElement.