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
一个 DOMString
包含反映 align
属性的枚举值。它指示元素内容相对于周围上下文的对齐方式。可能的值为 "left"
,"right"
和 "center"
。
HTMLTableCellElement.axis
一个 DOMString
,包含一个名称分组虚拟单元格。它反映了过时的 axis
属性。
HTMLTableCellElement.bgColor
一个 DOMString
,包含单元格的背景颜色。它反映了过时的 bgcolor
属性。
HTMLTableCellElement.ch
一个 DOMString
,包含一个单一的字符。该字符用于对齐一列的所有单元格。它反映了 char
并默认为与语言相关的小数点,例如 '.'
表示英语,或 ','
表示法语。此属性是可选的,并没有得到很好的支持。
HTMLTableCellElement.chOff
一个 DOMString
,表示在 HTMLTableCellElement.ch
定义的字符的右边(对于从左到右的脚本;如果是从右到左的脚本则为左边)必须留下多少个字符。此属性是可选的,并没有得到很好的支持。
HTMLTableCellElement.height
一个 DOMString
,包含单元格高度的像素长度。它反映了过时的 height
属性。
HTMLTableCellElement.noWrap
一个布尔值,反映了 nowrap
属性,指示单元格内容是否可以分成几行。
HTMLTableCellElement.vAlign
一个 DOMString
,表示一个枚举值,指示单元格的内容必须如何垂直对齐。它反映了 valign
属性,并且可以具有以下值之一:"top"
、"middle"
、"bottom"
或 "baseline"
. 请改用 CSS vertical-align
属性。
HTMLTableCellElement.width
一个 DOMString
,指定应绘制单元格宽度的像素数(如果可能的话)。该属性反映了也过时 width
属性。请改用 CSS width
属性。
规范
规范 |
---|
HTML Standard (HTML) htmltablecellelement |
桌面浏览器兼容性
暂无兼容数据
相关链接
- 实现此接口的 HTML 元素:
<th>
和<td>
,分别通过继承HTMLTableHeaderCellElement
和HTMLTableDataCellElement
实现。