{hero}

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.'
);

相關

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