page.info()
自:DataTables 1.10
取得表格的分頁資訊。
描述
表格的分頁狀態通常對於了解表格在任何時間顯示的資料很有用 - 事實上,即使 paging
被停用,也可以取得表格中的記錄數資訊。
此方法提供有關表格分頁狀態的資訊,以及有關表格中的記錄數(總數和搜尋結果集)的資訊。
返回的物件具有以下屬性
page
- 當前頁面的索引(以零為基礎 - 即第一頁為0
)pages
- 總頁數start
- 當前頁面上顯示的第一筆記錄的顯示索引end
- 當前頁面上顯示的最後一筆記錄的顯示索引length
- 顯示長度(記錄數)。請注意,通常start + length = end
,但這並不總是正確,例如,如果最後一頁只顯示 2 筆記錄,而長度為 10。recordsTotal
- 完整資料集長度recordsDisplay
- 套用目前搜尋條件後的資料集長度。serverSide
- 一個布林值,指示表格是否在伺服器端處理模式下運作(serverSide
)。在處理分頁和 API 時,當索引結果可能會被顯示起始點偏移時,這會很有用。
返回物件範例
{
"page": 1,
"pages": 6,
"start": 10,
"end": 20,
"length": 10,
"recordsTotal": 57,
"recordsDisplay": 57,
"serverSide": false
}
類型
function page.info()
- 描述
取得有關表格分頁狀態的資訊。請注意,如果 API 環境中有多個表格可用,將使用環境中第一個表格的分頁長度。如果您在單個 API 環境中使用多個表格,請使用
table()
。- 返回
包含表格分頁狀態資訊的物件(如下所述)。
範例
取得表格中的目前頁面和記錄數
var table = new DataTable('#myTable');
var info = table.page.info();
$('#tableInfo').html(
'Currently showing page ' + (info.page + 1) + ' of ' + info.pages + ' pages.'
);
相關
以下選項直接相關,也可能在您的應用程式開發中很有用。