# Pagination 分页

当数据量过多时,使用分页分解数据。

# 基础用法

设置total表示总条目数,size用于设置每页显示的页码数量。

显示代码

# 设置最大页码按钮数

默认情况下,当总页数超过 7 页时,Pagination 会折叠多余的页码按钮。通过pager-count属性可以设置最大页

显示代码

# 带有背景色的分页

设置background属性可以为分页按钮添加背景色。

显示代码

# 禁用分页

显示代码

# Attributes

参数 说明 类型 可选值 默认值
small 是否使用小型分页样式 boolean false
background 是否为分页按钮添加背景色 boolean false
page-size 每页显示条目个数,支持 .sync 修饰符 number 10
total 总条目数 number
page-count 总页数,total 和 page-count 设置任意一个就可以达到显示页码的功能;如果要支持 page-sizes 的更改,则需要使用 total 属性 Number
pager-count 页码按钮的数量,当总页数超过该值时会折叠 number 大于等于 5 且小于等于 21 的奇数 7
current-page 当前页数,支持 .sync 修饰符 number 1
page-sizes 每页显示个数选择器的选项设置 number[] [10, 20, 30, 40, 50, 100]
disabled 是否禁用 boolean false
hide-on-single-page 只有一页时是否隐藏 boolean -

# Events

事件名称 说明 回调参数
size-change pageSize 改变时会触发 每页条数
current-change currentPage 改变时会触发 当前页

# Slot

name 说明
自定义内容,需要在 layout 中列出 slot