{hero}

page.info()

自:DataTables 1.10

获取有关表格的分页信息。

描述

表格的分页状态通常有助于了解在任何给定时间在表格中显示的数据 - 实际上,即使分页已禁用,获取有关表格中原有记录数量的信息也很有用。

此方法提供有关表分页状态的信息,以及有关表中记录数量的信息(总数和搜索结果集中的数量)。

返回的对象具有以下属性

  • 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
}

类型

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

相关

以下选项直接相关,在应用程序开发中也可能有用。