分页组件文档 - layui.laypage

和layDate的第一个版本几乎同时间推出,由于几乎没有什么BUG,且功能基本比较完备,所以更新得也比较少。如今已经作为Layui的分页模块,并也将在后续进行一次优化,届时layPage将不再作为独立组件而维护

模块加载名称:laypage,layPage在线演示:http://www.layui.com/demo/laypage.html

语法:layui.laypage(settings)

参数 描述
settings

部分必填,部分可选。用于配置laypage的键值对集合。

默认值 类型 描述
cont 必填 String/Object 容器。值可以传入元素id或原生DOM或jquery对象,如:
  cont: 'id'
  //cont: document.getElementById('id')
  //cont: $('#id')
pages 必填 Number 分页数。一般通过服务端返回得到
curr 1 Number 当前页。
groups 5 Number 连续分页数。
skin default String 控制分页皮肤。一般传16进制色值即可,如:
skin: '#c00'
当然,您还可以借助自定义皮肤
first 1 Number/String/Boolean 用于控制首页。值支持三种类型。
如:first: '首页' 如:first: false,则表示不显示首页项
last 总页数值 Number/String/Boolean 用于控制尾页。值支持三种类型
如:last: '尾页' 如:last: false,则表示不显示尾页项
prev 上一页 String/Boolean 用于控制上一页。若不显示,设置false即可
next 下一页 String/Boolean 用于控制下一页。若不显示,设置false即可
skip false Boolean 是否显示跳转
hash undefined 任意 hash名,如果填写,则开启location.hash。触发分页时,会自动对url追加#!hash名={curr}
利用这个,可以在页面载入时就定位到指定页
jump 核心参数 Function 触发分页后的回调,函数返回两个参数。
obj是一个object类型。包括了分页的所有配置信息。
first一个Boolean类,检测页面是否初始加载。非常有用,可避免无限刷新。
  jump: function(obj, first){
    //得到了当前页,用于向服务端请求对应数据
    var curr = obj.curr;
  }

由于也是从之前的独立组件直接移入到layui,所以暂时不对其做详细介绍。在后面对laypage的重写中,本页也会重新编写。

Layui - 用心与你沟通