分页 - Pagination
使用$.fn.pagination.defaults重载默认值。
这个分页允许用户导航数据页面。它支持可配置选项页面导航和页面长度的选择。用户可以添加自定义按钮在正确的分页,增强其功能。
依赖组件(Dependencies)
使用方法(Usage Example)
创建分页标记。
使用javascript创建分页。
让我们创建ajax分页与面板和分页的插件。当用户选择一个新页面,面板将显示相应的内容的页面指定。
上面的面板显示第一个页面内容默认情况下。当用户浏览这个页面,“onSelectPage”事件将被触发,在我们所谓的“刷新”方法内容面板加载新页内容与一个新的URL参数。
属性(Properties)
名称 | 类型 | 描述 | 默认值 |
---|---|---|---|
total | number | 总记录数,当创建分页时必须设置。 | 1 |
pageSize | number | 每页显示的记录数。 | 10 |
pageNumber | number | 当分页创建完毕时显示当前页码。 | 1 |
pageList | array | 用户能够改变每页显示的记录数。
示例: $('#pp').pagination({ pageList: [10,20,50,100] }); |
[10,20,30,50] |
loading | boolean | 定义数据是否正在载入。 | false |
buttons | array | 自定义按钮,每个按钮包含2个属性: iconCls: 显示背景图片的CSS类 handler: 当按钮被点击时调用的一个句柄函数 The customize buttons can be declared from markup: <div class="easyui-pagination" style="border:1px solid #ccc" data-options=" total: 114, buttons: [{ iconCls:'icon-add', handler:function(){alert('add')} },'-',{ iconCls:'icon-save', handler:function(){alert('save')} }]"> </div> The customize buttons can also be created using javascript: $('#pp').pagination({ total: 114, buttons: [{ iconCls:'icon-add', handler:function(){alert('add')} },'-',{ iconCls:'icon-save', handler:function(){alert('save')} }] }); |
null |
showPageList | boolean | 定义是否显示可选择的每页记录数。 | true |
showRefresh | boolean | 定义是否显示刷新按钮。 | true |
beforePageText | string | 在输入框之前显示的符号。 | Page |
afterPageText | string | 在输入框之后显示的符号。 | of {pages} |
displayMsg | string | 在插件右上方显示分页信息。 | Displaying {from} to {to} of {total} items |
事件(Events)
名称 | 属性 | 描述 |
---|---|---|
onSelectPage | pageNumber, pageSize | 当用户进行翻页时触发,回调函数包含2个参数: pageNumber: 下一页的页码 pageSize: 下一页的显示记录数 示例: $('#pp').pagination({ onSelectPage:function(pageNumber, pageSize){ $(this).pagination('loading'); alert('pageNumber:'+pageNumber+',pageSize:'+pageSize); $(this).pagination('loaded'); } }); |
onBeforeRefresh | pageNumber, pageSize | 刷新之前触发, 返回false将取消刷新。 |
onRefresh | pageNumber, pageSize | 刷新之后触发。 |
onChangePageSize | pageSize | 当用户修改每页显示记录数时触发。 |
方法(Methods)
名称 | 属性 | 描述 |
---|---|---|
options | none | 返回分页属性对象。 |
loading | none | 提醒分页插件正在载入。 |
loaded | none | 提醒分页插件已经载入。 |
refresh | options |
刷新并显示信息。这个方法版本1.3可用。。
示例: $('#pp').pagination('refresh'); // 刷新页面右栏的信息 $('#pp').pagination('refresh',{ // 改变选项并刷新页面右栏的信息 total: 114, pageNumber: 6 }); |
select | page | 选择一个新页面。页面索引从1开始。这个方法版本1.3可用。 示例: $('#pp').pagination('select'); // refresh the current page $('#pp').pagination('select', 2); // select the second page |