{hero}

table().header.structure()

自:DataTables 2.0

获取表格表头结构的 Javascript 表示形式。

描述

此方法提供了获取表格表头的 HTML 结构的 Javascript 原生表示形式的功能。它允许复杂的表头(即使用 colspanrowspan 属性的单元格)和多行表头。

返回的数据结构具有一个顶级数组,其中每一行在表头中有一个条目。每行条目都是一个对象数组或一个 null 值。对象结构用于描述表格单元格,并具有以下属性

  • colspan - 单元格跨越的列数
  • cell - 单元格的 HTML 元素(thtd
  • 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 ] )

描述

获取表格表头的结构

参数
返回

包含对象和 null 值的数组,用于描述表头结构。有关更多详细信息,请参阅描述。

相关

以下选项直接相关,并且在应用程序开发中也可能有用。