each()
自:DataTables 1.10 起
迭代 API 結果集中的內容。
描述
此方法利用了 DataTables API 物件是「類陣列」的事實,也就是說,它們繼承了許多 Javascript Array
類型的功能和方法。
請注意,當使用複數方法,例如 rows()
和 columns()
時,您可能希望使用 rows().every()
、columns().every()
和 cells().every()
方法,以在將上下文設定為該表格元素的情況下迭代每一行、每一列或每一個儲存格。這聽起來可能有點複雜,但它可以大大簡化您的程式碼!請參閱每個 every
方法的文件以取得完整詳細資訊。
each()
方法是 Javascript Array.prototype.forEach
方法的代理,並作為 DataTables API 的實用方法提供。有關原始方法的更多資訊,請參閱 Mozilla MDN 關於 forEach
的文件。在不原生支援 forEach
的瀏覽器中,會提供 polyfill 以允許此 DataTables 方法如預期般運作。
類型
function each( fn )
- 描述
迭代 API 結果集中的內容。
- 參數
名稱 類型 選填 1 fn
否 針對 API 實例結果集中的每個項目呼叫的回呼函式。回呼函式會使用三個參數呼叫
- 元素值
- 結果集中的元素索引
- 正在遍歷的 API 實例
不預期有傳回值。
- 傳回
使用的原始 API 實例。用於鏈接。
範例
迴圈處理來自欄位的資料
var table = new DataTable('#myTable');
table
.column(0)
.data()
.each(function (value, index) {
console.log('Data in index: ' + index + ' is: ' + value);
});