fineui/docs/base/pager.md

bi.pager

分页控件,基类BI.Widget

{% method %} source

{% common %}

BI.createWidget({
  type: "bi.pager",
  height: 50,
  pages: 18,
  groups: 5,
  curr: 6,
  first: "首页",
  last: "尾页"
});

{% endmethod %}

API

基础属性

参数	说明	类型	可选值	默认值
behaviors	自定义列表中item项的行为，如高亮，标红等	object	—	{}
layouts	布局	array	—	{type:"bi.horizontal",hgap:10,vgap:0}
dynamicShow	是否动态显示上一页、下一页、首页、尾页， 若为false，则指对其设置使能状态	boolean	true,false	true
dynamicShowFirstLast	是否动态显示首页、尾页,dynamicShow为false时生效	boolean	true,false	false
dynamicShowPrevNext	是否动态显示上一页、下一页,dynamicShow为false时生效	boolean	true,false	false
pages	是否显示总页数	boolean	true,false	false
curr	初始化当前页	function	—	function(){return 1;}
groups	连续显示分页数	number	—	0
jump	页数跳转	function	—	—
first	是否显示首页	boolean	true,false	false
last	是否显示尾页	boolean	true,false	false
prev	上一页	string,object —	—	"上一页"
next	下一页	sting,object	—	"下一页"
firstPage	第一页	number	—	1
lastPage	最后一页,在万不得已时才会调用这个函数获取最后一页的页码, 主要作用于setValue方法	function	—	function(){ return 1;}
hasPrev	判断是否有上一页,pages不可用时有效	function	—	—
hasNext	判断是否有下一页,pages不可用时有效	function	—	—

对外方法

名称	说明	回调参数
getCurrentPage	获取当前页码	—
setAllPages	设置总页数	pages
hasPrev	判断是否有上一页	v
hasNext	判断是否有下一页	v
setValue	设置当前页码	v
getValue	获取当前页码	—
attr	设置属性	key,value
populate	刷新或者清空列表	—

事件

名称	说明
BI.Pager.EVENT_AFTER_POPULATE	pager刷新完成事件

---