HTMLTableSectionElement - 表示 <tfoot>,<thead> 和 <tbody> 元素
HTMLTableSectionElement
接口提供了特殊的属性和方法(除了通过继承通用的 HTMLElement
接口获得的常规属性和方法)来操作表格章节(即 HTML 表格中的标题,页脚和正文)的布局和表示。
属性
从其父接口 HTMLElement
继承了属性。
HTMLTableSectionElement.align
一个 DOMString
,其中包含反映 align
属性的枚举值。它表示元素内容相对于周围环境的对齐。可能的值是 "left"
,"right" 和
"center"`。
HTMLTableSectionElement.rows
只读
返回包含章节中行的实时 HTMLCollection
。 HTMLCollection
是实时的,并在添加或删除行时自动更新。
HTMLTableSectionElement.ch
一个 DOMString
,包含一个单个字符。此字符是用于对齐列的所有单元格的字符。它反映了 char
,默认为与该语言相关的小数点,例如英语的 '.'
,法语的 ','
。此属性是可选的,并且在浏览器中得不到很好的支持。
HTMLTableSectionElement.chOff
一个 DOMString
,其中包含一个整数,表示必须在 HTMLTableSectionElement.ch
定义的字符右侧(从左到右的脚本; 或左侧为从右到左的脚本)留下多少个字符。此属性是可选的,并且在浏览器中得不到很好的支持。
HTMLTableSectionElement.vAlign
一个 DOMString
枚举值,表示单元格的内容必须如何垂直对齐。它反映了 valign
属性,并且可以具有以下值之一:"top"
,"middle"
,"bottom"
或 "baseline"
。
方法
从其父接口 HTMLElement
继承了方法。
HTMLTableSectionElement.deleteRow()
删除章节中给定位置的单元格。如果给定位置大于(或者等于,因为是从零开始的)该章节中的行数,或者小于 0
,则引发值为 IndexSizeError
的 DOMException
。
HTMLTableSectionElement.insertRow()
在该章节中的给定位置之前插入一个新行。如果给定的位置没有给出或是 -1
,它会将行追加到章节的末尾。如果给定位置大于(或者等于,因为是从零开始的)该章节中的行数,或者小于 -1
,则引发值为 IndexSizeError
的 DOMException
。
规范
规范 | 状态 | 备注 |
---|---|---|
HTML Living Standard HTMLTableSectionElement 的定义 |
现行的标准 | - |
HTML5 HTMLTableSectionElement 的定义 |
推荐 | insertCell 的参数现在是可选的。 |
Document Object Model (DOM) Level 2 HTML Specification HTMLTableSectionElement 的定义 |
已过时 | insertRow 和 deleteRow 方法可能引发异常。 |
Document Object Model (DOM) Level 1 Specification HTMLTableSectionElement 的定义 |
已过时 | 初始定义。 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
align | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
ch | 未知 | 不支持 | 不支持 | 未知 | 未知 | 未知 |
chOff | 未知 | 不支持 | 不支持 | 未知 | 未知 | 未知 |
deleteRow | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
insertRow | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
rows | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
vAlign | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
align | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
ch | 未知 | 未知 | 不支持 | 不支持 | 未知 | 未知 | 未知 |
chOff | 未知 | 未知 | 不支持 | 不支持 | 未知 | 未知 | 未知 |
deleteRow | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
insertRow | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
rows | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
vAlign | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |