{hero}

data()

自 DataTables 1.10 起

取得整個表格的資料。

描述

此方法提供對 API 環境中表格中每列所使用的原始資料的存取權。結果集包含原始資料(無論是陣列或物件),其中每一列都由 API 結果集中的一個條目定義。列的順序是列資料索引(即資料最初讀入表格的順序)。

如果您修改返回的陣列中包含的資料,請確保您使用 rows().invalidate()row().invalidate() 或任何其他失效方法,以使 DataTables 注意到變更並重新讀取資料來源。

請注意,rows().data() 方法也可以提供對此資料的完全存取權,但方式更具彈性,因為它允許透過 selector-modifier 選項物件在結果集中修改列排序、分頁和搜尋。例如,rows({'order':'index'}).data()data() 完全相同 - 兩者都按資料索引順序排列,而 rows().data() 將返回完整資料集,但會以目前的顯示順序返回(由 order() 定義)。

類型

function data()

描述

依列索引順序檢索整個表格的資料。

返回

DataTables API 實例,結果集中包含表格中每一列的資料。

範例

顯示一個警示,其中顯示表格中有多少列資料

var table = new DataTable('#myTable');

alert('There are' + table.data().length + ' row(s) of data in this table');

修改資料,然後使顯示失效以重新繪製

var table = new DataTable('#myTable');

// Increment a counter for each row
table.data().each(function (d) {
	d.counter++;
});

// Invalidate all rows and redraw
table
	.rows()
	.invalidate()
	.draw();

相關

以下選項直接相關,也可能在您的應用程式開發中很有用。