data() 获取表格的数据文档(Options & API) DataTables中文网

描述(Description)

该方法提供获取当前API上下文每行的原始数据。结果集包含原始数据（无论是数组还是对象），每行由API结果集中的条目定义。行的顺序就是行数据索引（即数据最初读入表的顺序）。

如果你要修改的数据包含在返回的数组中，确保你使用了 rows().invalidate()API , row().invalidate()API 或者任何其他失效的方法来让DataTables注意到更改并且重新读取数据源。

请注意 rows().data()API 方法可以完全访问该数据，为了更灵活的获取数据，还可以通过 selector-modifierType 选项对对象结果集进行排序，分页和搜索修改。例如rows({'order':'index'}).data()和rows().data()完全相同-两者都是数据索引顺序，然而rows().data() 将会返回全部的结果集，而rows({'order':'index'}).data()取决于当前显示顺序（由 order()API 定义）

类型(Type)

这个选项能够接受以下类型的参数：

function data()

描述(Description):

以行索引顺序检索整个表的数据

返回(Returns):

DataTables.ApiType

包含表格中每行的数据的结果集的DataTables API实例

例子(Example)

显示多少条数据在表格中

1
2
3
var table = $('#example').DataTable();
 
alert( '有'+table.data().length+' 条数据在表格中' );

修改数据，然后使数据失效，再重绘表格

1
2
3
4
5
6
7
8
9
var table = $('#example').DataTable();
 
//在每一行增加一个计数器
table.data().each( function (d) {
    d.counter++;
} );
 
// 失效所有行并且重绘
table.rows().invalidate().draw();