page()
始于:DataTables 1.10
获取/设置表的当前页。
说明
分页是 DataTables 的核心功能,该方法提供对表所显示页面的外部控制。如果你想为表提供自定义分页控件,该控件位于内置分页控件选项或分页插件选项外部,这可能会非常有用。
请注意,如果你尝试使用此方法的 set 格式显示一个不存在的页面,DataTables 不会引发错误,而会将分页重置为第一页。
请注意,此方法设置要显示的页面 - 它不会实际执行表的重新显示。为了显示已设置的新页面,请使用 draw()
方法,可以将其简单地调用为 page()
方法返回的对象的链式方法 - 例如 table.page( 0 ).draw( false );
。
此外,请注意,你应将 false
或 page
作为第一个参数传递给 draw()
以便它进行驻留重绘。如果没有此参数,draw()
将进行完全绘图,导致分页重置回第一页!
类型
函数 page()
- 说明
获取表的当前页。请注意,如果 API 的上下文中有多个表可用,将使用上下文中第一个表的当前页索引。如果你在单个 API 上下文中使用多个表,请使用
table()
。- 返回
当前显示的页号
实例
下一页/上一页的自定义分页控件
var table = new DataTable('#myTable');
$('#next').on('click', function () {
table.page('next').draw('page');
});
$('#previous').on('click', function () {
table.page('previous').draw('page');
});
相关
以下选项直接相关,在你的应用程序开发中也非常有用。