Page 分页

概述

当数据量较多时,使用分页可以快速进行数据切换。

代码示例

Page 分页 - 图1

基本

基本的分页,页数过多时会自动折叠。

  1. <template>
  2. <Page :total="100" />
  3. </template>
  4. <script>
  5. export default {
  6. }
  7. </script>

Page 分页 - 图2

每页数量

可以切换每页显示的数量。

  1. <template>
  2. <Page :total="100" show-sizer />
  3. </template>
  4. <script>
  5. export default {
  6. }
  7. </script>

Page 分页 - 图3

电梯

快速跳转到某一页。

  1. <template>
  2. <Page :total="100" show-elevator />
  3. </template>
  4. <script>
  5. export default {
  6. }
  7. </script>

Page 分页 - 图4

总数

显示总共多少条数据,接受 slot 来自定义内容,默认显示共{{ total }}条

  1. <template>
  2. <Page :total="100" show-total />
  3. </template>
  4. <script>
  5. export default {
  6. }
  7. </script>

Page 分页 - 图5

迷你型

设置sizesmall使用迷你型,迷你型拥有普通的所有功能。

  1. <template>
  2. <Page :total="40" size="small" />
  3. <Page :total="40" size="small" show-elevator show-sizer />
  4. <Page :total="40" size="small" show-total />
  5. </template>
  6. <script>
  7. export default {
  8. }
  9. </script>

Page 分页 - 图6

简洁

设置simple属性即可使用简洁版的分页,通过输入页码回车切换,或使用鼠标点击切换页码,或使用键盘的上下键来切换。简洁分页不能使用总数、电梯和切换数量。

  1. <template>
  2. <Page :current="2" :total="50" simple />
  3. </template>
  4. <script>
  5. export default {
  6. }
  7. </script>

Page 分页 - 图7

上一页和下一页

使用属性 prev-textnext-text,替代图标显示为文字。

  1. <template>
  2. <Page :total="100" prev-text="Previous" next-text="Next" />
  3. </template>
  4. <script>
  5. export default {
  6. }
  7. </script>

API

Page props

属性 说明 类型 默认值
current 当前页码,支持 .sync 修饰符 Number 1
total 数据总数 Number 0
page-size 每页条数 Number 10
page-size-opts 每页条数切换的配置 Array [10, 20, 30, 40]
placement 条数切换弹窗的展开方向,可选值为 bottomtop String bottom
size 可选值为small(迷你版)或不填(默认) String -
simple 简洁版 Boolean false
show-total 显示总数 Boolean false
show-elevator 显示电梯,可以快速切换到某一页 Boolean false
show-sizer 显示分页,用来改变page-size Boolean false
class-name 自定义 class 名称 String -
styles 自定义 style 样式 Object -
transfer 是否将弹层放置于 body 内,在 Tabs、带有 fixed 的 Table 列内使用时,建议添加此属性,它将不受父级样式影响,从而达到更好的效果 Boolean false
prev-text 替代图标显示的上一页文字 String -
next-text 替代图标显示的下一页文字 String -
disabled 4.0.0 是否禁用 Boolean false

Page events

事件名 说明 返回值
on-change 页码改变的回调,返回改变后的页码 页码
on-page-size-change 切换每页条数时的回调,返回切换后的每页条数 page-size

Page slot

名称 说明
自定义显示总数的内容