{hero}

page()

始于:DataTables 1.10

获取/设置表的当前页。

说明

分页是 DataTables 的核心功能,该方法提供对表所显示页面的外部控制。如果你想为表提供自定义分页控件,该控件位于内置分页控件选项或分页插件选项外部,这可能会非常有用。

请注意,如果你尝试使用此方法的 set 格式显示一个不存在的页面,DataTables 不会引发错误,而会将分页重置为第一页。

请注意,此方法设置要显示的页面 - 它不会实际执行表的重新显示。为了显示已设置的新页面,请使用 draw() 方法,可以将其简单地调用为 page() 方法返回的对象的链式方法 - 例如 table.page( 0 ).draw( false );

此外,请注意,你应将 falsepage 作为第一个参数传递给 draw() 以便它进行驻留重绘。如果没有此参数,draw() 将进行完全绘图,导致分页重置回第一页!

类型

函数 page()

说明

获取表的当前页。请注意,如果 API 的上下文中有多个表可用,将使用上下文中第一个表的当前页索引。如果你在单个 API 上下文中使用多个表,请使用 table()

返回

当前显示的页号

函数 page( set )

说明

设置表要显示的页面

参数
返回

DataTables API 实例

实例

下一页/上一页的自定义分页控件

var table = new DataTable('#myTable');

$('#next').on('click', function () {
	table.page('next').draw('page');
});

$('#previous').on('click', function () {
	table.page('previous').draw('page');
});

相关

以下选项直接相关,在你的应用程序开发中也非常有用。