我们的志愿者还没有将这篇文章翻译为 中文 (简体)。加入我们帮助完成翻译!
您也可以阅读此文章的English (US)版。
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.
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25 351,20 351,30 341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25 501,20 501,30 491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableCellElement" target="_top"><rect x="291" y="65" width="200" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="391" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLTableCellElement</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
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 thecolspan
attribute. HTMLTableCellElement.rowSpan
- Is a
unsigned
long
that represents the number of rows this cell must span. It reflects therowspan
attribute. HTMLTableCellElement.headers
Read only- Is a
DOMSettableTokenList
describing a list ofid
of<th>
elements that represents headers associated with the cell. It reflects theheaders
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 thealign
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 obsoletebgcolor
attribute. HTMLTableCellElement.axis
- Is a
DOMString
containing a name grouping cells in virtual. It reflects the obsoleteaxis
attribute. HTMLTableCellElement.height
- Is a
DOMString
containing a length of pixel of the hinted height of the cell. It reflects the obsoleteheight
attribute. HTMLTableCellElement.width
- Is a
DOMString
containing a length of pixel of the hinted width of the cell. It reflects the obsoletewidth
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 thechar
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 byHTMLTableCellElement.ch
. This property was optional and was not very well supported. HTMLTableCellElement.noWrap
- Is a
Boolean
value reflecting thenowrap
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 thevalign
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 | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | 1.0 (1.7 or earlier) | (Yes) | (Yes) | (Yes) |
ch and chOff |
? | (Yes) | (Yes) | ? | ? | ? |
Feature | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | 1.0 (1.0) | (Yes) | (Yes) | (Yes) |
ch and chOff |
? | (Yes) | (Yes) | ? | ? | ? |
See also
- The HTML elements implementing this interface:
<th>
and<td>
by inheritance viaHTMLTableHeaderCellElement
andHTMLTableDataCellElement
.