fineui/docs/base/pager.md

# bi.pager

## 分页控件,基类[BI.Widget](/core/widget.md)

{% method %}
[source](https://jsfiddle.net/fineui/rhhte9b3/)

{% common %}
```javascript

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刷新完成事件   |

---