columns().footer()
自:DataTables 1.10 起
取得所選欄位的頁腳節點。
說明
此方法可用於取得(並因此修改)多個欄位使用的頁腳儲存格。這可能由 th
和/或 td
元素組成,具體取決於表格的 HTML。
傳回的儲存格是表格中第一個 tfoot
元素中與所選欄位相關的儲存格。如果您的頁腳有多個要操作的列,您需要使用 table().footer()
方法來取得表格頁腳元素,然後使用標準 DOM / jQuery 方法來操作節點。
此外,tfoot
中的儲存格可以使用 colspan
來跨越多個欄位(它們也可以使用 rowspan
,但同樣,只有第一列中的儲存格可以使用此方法)。因此,使用 colspan
的儲存格可能屬於多個欄位。
請注意,表格頁腳在 DataTables 中是可選的。如果從 columns()
呼叫中找到的欄位沒有頁腳元素,則會傳回空的結果集。
類型
function columns().footer( [row] )
- 說明
取得所選欄位的頁腳
th
/td
儲存格。- 參數
名稱 類型 選填 1 row
是 自 2.0 起:此參數可用於控制將從
tfoot
中讀取頁腳儲存格的列。如果未定義,將使用頁腳中的第一列。- 傳回值
DataTables API 實例,其結果集中包含所選欄位的頁首儲存格。
範例
將所有具有 .sum
類別的欄位相加,並將總和放入其頁腳儲存格
var table = new DataTable('#myTable');
table.columns('.sum').every(function () {
var sum = this.data().reduce(function (a, b) {
return a + b;
});
$(this.footer()).html('Sum: ' + sum);
});
相關
以下選項直接相關,也可能在您的應用程式開發中很有用。