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 an unsignedlongthat represents the number of columns this cell must span. It reflects thecolspanattribute.
- HTMLTableCellElement.rowSpan
- Is an unsignedlongthat represents the number of rows this cell must span. It reflects therowspanattribute.
- HTMLTableCellElement.headersRead only
- Is a DOMSettableTokenListdescribing a list ofidof<th>elements that represents headers associated with the cell. It reflects theheadersattribute.
- HTMLTableCellElement.cellIndexRead only
- Is a longrepresenting 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 DOMStringcontaining an enumerated value reflecting thealignattribute. 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 DOMStringcontaining the background color of the cells. It reflects the obsoletebgcolorattribute.
- HTMLTableCellElement.axis
- Is a DOMStringcontaining a name grouping cells in virtual. It reflects the obsoleteaxisattribute.
- HTMLTableCellElement.height
- Is a DOMStringcontaining a length of pixel of the hinted height of the cell. It reflects the obsoleteheightattribute.
- HTMLTableCellElement.width
- Is a DOMStringcontaining a length of pixel of the hinted width of the cell. It reflects the obsoletewidthattribute.
- HTMLTableCellElement.ch
- Is a DOMStringcontaining one single chararcter. This character is the one to align all the cell of a column on. It reflects thecharand 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 DOMStringcontaining 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 byHTMLTableCellElement.ch. This property was optional and was not very well supported.
- HTMLTableCellElement.noWrap
- Is a Booleanvalue reflecting thenowrapattribute and indicating if cell content can be broken in several lines.
- HTMLTableCellElement.vAlign
- Is a DOMStringrepresenting an enumerated value indicating how the content of the cell must be vertically aligned. It reflects thevalignattribute 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, andvAlign.The headersproperty is now read-only and contains aDOMSettableTokenListrather than a mereDOMString.The colspanandrowspanproperties are nowunsigned long. | 
| Document Object Model (DOM) Level 2 HTML Specification The definition of 'HTMLTableCellElement' in that specification. | Recommendation | The cellIndexproperty 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) | 
| chandchOff | ? | Not supported | ? | ? | ? | 
| Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile | 
|---|---|---|---|---|---|
| Basic support | (Yes) | 1.0 (1.0) | (Yes) | (Yes) | (Yes) | 
| chandchOff | ? | Not supported | ? | ? | ? | 
See also
- The HTML elements implementing this interface: <th>and<td>by inheritance viaHTMLTableHeaderCellElementandHTMLTableDataCellElement.