table().header.structure()
自:DataTables 2.0
获取表格表头结构的 Javascript 表示形式。
描述
此方法提供了获取表格表头的 HTML 结构的 Javascript 原生表示形式的功能。它允许复杂的表头(即使用 colspan
和 rowspan
属性的单元格)和多行表头。
返回的数据结构具有一个顶级数组,其中每一行在表头中有一个条目。每行条目都是一个对象数组或一个 null 值。对象结构用于描述表格单元格,并具有以下属性
colspan
- 单元格跨越的列数cell
- 单元格的 HTML 元素(th
或td
)rowspan
- 单元格跨越的行数title
- 单元格的标题文本。
一个 null
值替代对象表示由于前一个单元格的 rowspan 或 colspan 属性而跨越到该单元格的单元格。
例如,考虑以下用于表格表头的 HTML
<thead>
<tr>
<th rowspan="2" width="15%">Name</th>
<th colspan="2">Position</th>
<th colspan="3">Contact</th>
</tr>
<tr>
<th colspan="3" data-dt-order="disable">HR info</th>
<th colspan="2">Direct</th>
</tr>
</thead>
通过此方法读取时,结果将为
[
[
{colspan: 1, rowspan: 2, cell: <th>, title: 'Name'},
{colspan: 2, rowspan: 1, cell: <th>, title: 'Position'},
null,
{colspan: 3, rowspan: 1, cell: <th>, title: 'Contact'},
null,
null
],
[
null,
{colspan: 3, rowspan: 1, cell: <th>, title: 'HR info'},
null,
null,
{colspan: 2, rowspan: 1, cell: <th>, title: 'Direct'},
null
]
]
类型
function table().header.structure( [ columns ] )
- 描述
获取表格表头的结构
- 参数
名称 类型 可选 1 columns
是 选择获取表头单元格的列。默认情况下,将检索表格中的所有列(无论可见性如何)。
- 返回
包含对象和 null 值的数组,用于描述表头结构。有关更多详细信息,请参阅描述。
相关
以下选项直接相关,并且在应用程序开发中也可能有用。