Pagination 分页

采用分页的形式分隔长列表,每次只加载一个页面。

何时使用

  • 当加载/渲染所有数据将花费很多时间时;
  • 可切换页码浏览数据。

代码演示

基本

基础分页。

expand code expand code

更多

更多分页。

expand code expand code

改变

改变每页显示条目数。

expand code expand code

自定义下拉选项

自定义下拉选项,例如添加全部选项

expand code expand code

跳转

快速跳转到某一页。

expand code expand code

迷你

迷你版本。

expand code expand code
  • 5

简洁

简单的翻页。

expand code expand code

受控

受控制的页码。

expand code expand code

总数

通过设置 showTotal 展示总共有多少数据。

expand code expand code

上一步和下一步

修改上一步和下一步为文字链接。

expand code expand code

API

参数 说明 类型 默认值
current(v-model) 当前页数 number -
defaultCurrent 默认的当前页数 number 1
defaultPageSize 默认的每页条数 number 10
hideOnSinglePage 只有一页时是否隐藏分页器 boolean false
itemRender 用于自定义页码的结构,可用于优化 SEO (page, type: 'page' | 'prev' | 'next', originalElement) => vNode -
pageSize(.sync) 每页条数 number -
pageSizeOptions 指定每页可以显示多少条 string[] ['10', '20', '30', '40']
showQuickJumper 是否可以快速跳转至某页 boolean false
showSizeChanger 是否可以改变 pageSize boolean false
showTotal 用于显示数据总量和当前数据顺序 Function(total, range) -
simple 当添加该属性时,显示为简单分页 boolean -
size 当为「small」时,是小尺寸分页 string ""
total 数据总数 number 0

事件

事件名称 说明 回调参数
change 页码改变的回调,参数是改变后的页码及每页条数 Function(page, pageSize)
showSizeChange pageSize 变化的回调 Function(current, size)
  Menu 导航菜单Steps 步骤条