HTMLTableCellElement - 用于操纵 HTML 文档中表格单元格的布局和呈现
HTMLTableCellElement
接口提供了特有的属性和方法(除了从 HTMLElement
接口继承获得的常规的属性和方法)用于操纵 HTML 文档中表格单元格(标题或数据单元格)的布局和呈现。
属性
从其父接口 HTMLElement
继承了属性。
HTMLTableCellElement.abbr
一个 DOMString
可以用于 <th>
元素(不用于 <td>
),指定标题单元格的替代标签。此替代标签可以在其他情况下使用,例如在描述适用于数据单元的标题时。它被用来提供一个较短的术语,特别是供屏幕阅读器使用,是一个有价值的辅助工具。通常情况下,abbr
的值是一个缩写或首字母缩写,但也可以是任何适合上下文的文本。
HTMLTableCellElement.cellIndex
只读
一个长整数,表示该单元格在 <tr>
单元格
集合中的位置。如果该单元格不属于 <tr>
,它将返回 -1
。
HTMLTableCellElement.colSpan
一个无符号长整数,表示此单元格必须跨越的列数;它让单元格占据表格的多个列的空间。它反映了 colspan
属性。
HTMLTableCellElement.headers
只读
一个 DOMSettableTokenList
,描述 <th>
元素的 id
列表,表示与单元格关联的标题。它反映了 headers
属性。
HTMLTableCellElement.rowSpan
一个无符号长整数,表示该单元格必须跨越的行数;它让一个单元格占据表格的多行空间。它反映了 rowspan
属性。
HTMLTableCellElement.scope
一个 DOMString
,表示 <th>
单元格的范围。可以使用 scope
属性配置标题单元格,将其应用于指定的行或列,或应用于当前行组中尚未确定范围的单元格(即,同一祖先的 <thead>
、<tbody>
或 <tfoot>
元素)。如果没有为 scope
指定值,则标题不会以这种方式直接与单元格关联。scope
的允许值为:
col
标题单元格适用于同一列(如果还使用了 colspan
的话,则是多列)中的后续单元格,直到该列的末尾或该列中的另一个 <th>
建立了一个新的范围。
colgroup
标题单元格适用于当前列组中尚未应用范围的所有单元格。仅当单元格在列组中时才允许使用此值。
row
标题单元格适用于同一行(如果还使用了 rowspan
的话,则是多行)中的后续单元格,直到行尾或另一个 <th>
在同一行中建立了一个新的作用域。
rowgroup
标题单元格适用于当前行组中尚未应用范围的所有单元格。只有当单元格在行组中时才允许使用这个值。
空字符串(""
)
标题单元格没有预定义的范围;用户代理将根据上下文线索建立范围。
方法
没有特有的方法;从其父接口 HTMLElement
继承了方法。
废弃的属性
警告: 这些属性已被废弃,不再使用。它们被记录下来主要是为了帮助理解旧的代码库。
HTMLTableCellElement.align
Deprecated
一个 DOMString
包含反映 align
属性的枚举值。它指示元素内容相对于周围上下文的对齐方式。可能的值为 "left"
,"right"
和 "center"
。
HTMLTableCellElement.axis
Deprecated
一个 DOMString
,包含一个名称分组虚拟单元格。它反映了过时的 axis
属性。
HTMLTableCellElement.bgColor
Deprecated
一个 DOMString
,包含单元格的背景颜色。它反映了过时的 bgcolor
属性。
HTMLTableCellElement.ch
Deprecated
一个 DOMString
,包含一个单一的字符。该字符用于对齐一列的所有单元格。它反映了 char
并默认为与语言相关的小数点,例如 '.'
表示英语,或 ','
表示法语。此属性是可选的,并没有得到很好的支持。
HTMLTableCellElement.chOff
Deprecated
一个 DOMString
,表示在 HTMLTableCellElement.ch
定义的字符的右边(对于从左到右的脚本;如果是从右到左的脚本则为左边)必须留下多少个字符。此属性是可选的,并没有得到很好的支持。
HTMLTableCellElement.height
Deprecated
一个 DOMString
,包含单元格高度的像素长度。它反映了过时的 height
属性。
HTMLTableCellElement.noWrap
Deprecated
一个布尔值,反映了 nowrap
属性,指示单元格内容是否可以分成几行。
HTMLTableCellElement.vAlign
Deprecated
一个 DOMString
,表示一个枚举值,指示单元格的内容必须如何垂直对齐。它反映了 valign
属性,并且可以具有以下值之一:"top"
、"middle"
、"bottom"
或 "baseline"
. 请改用 CSS vertical-align
属性。
HTMLTableCellElement.width
Deprecated
一个 DOMString
,指定应绘制单元格宽度的像素数(如果可能的话)。该属性反映了也过时 width
属性。请改用 CSS width
属性。
规范
规范 |
---|
HTML Standard (HTML) htmltablecellelement |
桌面浏览器兼容性
暂无兼容数据
相关链接
- 实现此接口的 HTML 元素:
<th>
和<td>
,分别通过继承HTMLTableHeaderCellElement
Deprecated 和HTMLTableDataCellElement
Deprecated 实现。