data()
自 DataTables 1.10 起
取得整個表格的資料。
描述
此方法提供對 API 環境中表格中每列所使用的原始資料的存取權。結果集包含原始資料(無論是陣列或物件),其中每一列都由 API 結果集中的一個條目定義。列的順序是列資料索引(即資料最初讀入表格的順序)。
如果您修改返回的陣列中包含的資料,請確保您使用 rows().invalidate()
、row().invalidate()
或任何其他失效方法,以使 DataTables 注意到變更並重新讀取資料來源。
請注意,rows().data()
方法也可以提供對此資料的完全存取權,但方式更具彈性,因為它允許透過 selector-modifier
選項物件在結果集中修改列排序、分頁和搜尋。例如,rows({'order':'index'}).data()
與 data()
完全相同 - 兩者都按資料索引順序排列,而 rows().data()
將返回完整資料集,但會以目前的顯示順序返回(由 order()
定義)。
類型
範例
顯示一個警示,其中顯示表格中有多少列資料
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();
相關
以下選項直接相關,也可能在您的應用程式開發中很有用。