# Pagination 分页组件
基础用法
页数较少时的效果
- 1
- 2
- 3
- 4
- 5
大于 7 页时的效果
- 1
- 2
- 3
- 4
- 5
- 6
- 100
设置最大页码按钮数
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 50
设置最大页码按钮数
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 50
带有背景色的分页
- 1
- 2
- 3
- 4
- 5
- 6
- 100
小型分页
在空间有限的情况下,可以使用简单的小型分页。- 1
- 2
- 3
- 4
- 5
附加功能
根据场景需要,可以添加其他功能模块。显示总数
共 1000 条
- 1
- 3
- 4
- 5
- 6
- 7
- 10
调整每页显示条数
- 1
- 3
- 4
- 5
- 6
- 7
- 10
直接前往
- 1
- 3
- 4
- 5
- 6
- 7
- 10
完整功能
共 400 条
- 1
- 2
- 3
- 4
当只有一页时隐藏分页
当只有一页时,通过设置 hide-on-single-page 属性来隐藏分页。- 1
# Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| small | 是否使用小型分页样式 | boolean | — | false |
| background | 是否为分页按钮添加背景色 | boolean | — | false |
| page-size | 每页显示条目个数,支持 .sync 修饰符 | number | — | 10 |
| total | 条目总数 | nunber | — | — |
| page-count | 总页数,total 和 page-count 设置任意一个就可以达到显示页码的功能;如果要支持 page-sizes 的更改,则需要使用 total 属性 | nunber | — | — |
| pager-count | 页码按钮的数量,当总页数超过该值时会折叠 | number | 大于等于 5 且小于等于 21 的奇数 | 7 |
| current-page | 当前页数,支持 .sync 修饰符 | number | — | 1 |
| layout | 组件布局,子组件名用逗号分隔 | string | sizes , prev , pager , next , jumper , -> , total , slot | 'prev, pager, next, jumper, ->, total' |
| page-sizes | 每页显示个数选择器的选项设置 | number[] | — | [10, 20, 30, 40, 50, 100] |
| popper-class | 每页显示个数选择器的下拉框类名 | string | — | — |
| prev-text | 替代图标显示的上一页文字 | string | — | — |
| next-text | 替代图标显示的下一页文字 | string | — | — |
| hide-on-single-page | 只有一页时是否隐藏 | boolean | — | — |
# Events
| 事件名称 | 说明 | 回调参数 |
|---|---|---|
| size-change | pageSize 改变时会触发 | 每页条数 |
| current-change | currentPage 改变时会触发 | 当前页 |
| prev-click | 用户点击上一页按钮改变当前页后触发 | 当前页 |
| next-click | 用户点击下一页按钮改变当前页后触发 | 当前页 |
# Slot
| name | 说明 |
|---|---|
| — | 自定义内容,需要在 layout 中列出 slot |