Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

HTMLTableCellElement

Our volunteers haven't translated this article into suomi yet. Join us and help get the job done!

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.colSpan
Is a unsigned long that represents the number of columns this cell must span. It reflects the colspan attribute.
HTMLTableCellElement.rowSpan
Is a unsigned long that represents the number of rows this cell must span. It reflects the rowspan 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.cellIndex Read only
Is a long representing the cell position in the cells collection of the <tr> it belongs to. If the cell doesn't belong to a <tr>, it returns -1.
HTMLTableCellElement.align
Is 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.bgColor
Is a DOMString containing the background color of the cells. It reflects the obsolete bgcolor attribute.
HTMLTableCellElement.axis
Is a DOMString containing a name grouping cells in virtual. It reflects the obsolete axis attribute.
HTMLTableCellElement.height
Is a DOMString containing a length of pixel of the hinted height of the cell. It reflects the obsolete height attribute.
HTMLTableCellElement.width
Is a DOMString containing a length of pixel of the hinted width of the cell. It reflects the obsolete width attribute.
HTMLTableCellElement.ch
Is 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
Is 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.noWrap
Is a Boolean value reflecting the nowrap attribute and indicating if cell content can be broken in several lines.
HTMLTableCellElement.vAlign
Is 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".

Methods

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

Specifications

Specification Status Comment
WHATWG HTML Living Standard
The definition of 'HTMLTableCellElement' in that specification.
Living Standard No change from HTML5.
HTML5
The definition of 'HTMLTableCellElement' in that specification.
Recommendation The following properties have been obsoleted: align, axis, bgColor, height, width, ch, chOff, noWrap, and vAlign.
The headers property is now read-only and contains a DOMSettableTokenList rather than a mere DOMString.
The colspan and rowspan properties are now unsigned long.
Document Object Model (DOM) Level 2 HTML Specification
The definition of 'HTMLTableCellElement' in that specification.
Recommendation The cellIndex property is now read-only.
Document Object Model (DOM) Level 1 Specification
The definition of 'HTMLTableCellElement' in that specification.
Recommendation Initial definition.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Yes) 1.0 (1.7 or earlier) (Yes) (Yes) (Yes)
ch and chOff ? No support ? ? ?
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support (Yes) 1.0 (1.0) (Yes) (Yes) (Yes)
ch and chOff ? No support ? ? ?

See also

 

Document Tags and Contributors

 Contributors to this page: slimsag, fscholz, teoli, kscarfone, WesDotIt
 Last updated by: slimsag,