# 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