分页

如果一页中显示的数据过多,请使用分页。

基本用法

使用您希望显示的不同分页元素设置 layout,并用逗号分隔。分页元素有:prev(导航到上一页的按钮)、next(导航到下一页的按钮)、pager(页面列表)、jumper(跳转输入)、total(项目总数)、 sizes(确定页面大小的选择)和->(该符号之后的每个元素都将被拉到右侧)。

When you have few pages
  • 1
  • 2
  • 3
  • 4
  • 5
When you have more than 7 pages
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 100

寻呼机数量

默认情况下,当分页超过 7 页时,分页会折叠额外的分页器按钮。这可以使用 pager-count 属性进行配置。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 50

带背景颜色的按钮

设置 background 属性,按钮将具有背景颜色。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 100

小分页

在空间有限的情况下使用小分页。

设置大小以更改 size。这是small的演示

  • 1
  • 2
  • 3
  • 4
  • 5
  • 1
  • 2
  • 3
  • 4
  • 5

当只有一页时隐藏分页

当只有一页时,通过设置hide-on-single-page属性隐藏分页。


  • 1

更多元素

根据您的场景添加更多模块。

此示例是一个完整的用例。它使用size-changecurrent-change事件来处理页面大小更改和当前页面更改。 page-sizes 接受整数数组,每个整数代表 sizes 选择选项中的不同页面大小,例如[100, 200, 300, 400] 表示选择将有四个选项:每页 100、200、300 或 400 项。

background:
disabled:

Total item count
Total 1000
  • 1
  • 3
  • 4
  • 5
  • 6
  • 7
  • 10
Change page size
  • 1
  • 3
  • 4
  • 5
  • 6
  • 7
  • 10
Jump to
  • 1
  • 3
  • 4
  • 5
  • 6
  • 7
  • 10
Go to
All combined
Total 400
  • 1
  • 2
  • 3
  • 4
Go to

API

属性

名称描述类型默认
大小 2.7.6分页尺寸枚举'默认'
背景按钮是否有背景色布尔值
页面大小 / v-model:页面大小每页的项目数数字
默认页面大小页面大小默认初始值,不设置与设置10相同数字
总计项目总数数字
页数总页数。设置totalpage-count,将显示页面;如果您需要page-sizes,则需要total数字
寻呼机计数寻呼机的数量。当总页数超过此值时分页崩溃编号7
当前页 / v-model:当前页当前页码数字
默认当前页面current-page默认初始值,不设置与设置1相同数字
布局分页布局,元素用逗号分隔字符串上一页、寻呼机、下一页、跳线、->、总计
页面大小每页项目数选项数组[10, 20, 30, 40, 50, 100]
追加大小到 2.8.4大小下拉列表附加到哪个元素字符串
波普尔级页面大小的自定义类名称选择的下拉列表字符串''
波普风格 2.11.5页面大小的自定义样式选择下拉菜单字符串 / 对象
上一篇上一个按钮的文本字符串''
上一个图标上一个按钮的图标,优先级低于 prev-text字符串 / 组件向左箭头
下一个文本下一个按钮的文本字符串''
下一个图标下一个按钮的图标,优先级低于 next-text字符串 / 组件向右箭头
已禁用是否禁用分页布尔值
传送 2.3.13分页选择下拉列表是否传送到正文布尔值真实
隐藏在单页上只有一页时是否隐藏布尔值
小 ^(已弃用)是否使用小分页布尔值

WARNING

我们会检测一些已弃用的用法,如果您的分页未按预期显示或工作,请检查以下规则:

  • 您必须定义totalpage-count之一,否则我们无法确定总页数。当两者都定义时,page-count优先。
  • 如果定义了current-page,则必须监听current-page的更改,同时定义@update:current-page,否则分页不起作用。
  • 如果在显示页面大小选择器时定义了 page-sizesizes 包含在 layout 中),则还必须通过定义 @update:page-size 来监听 page-size 的更改,否则页面大小的更改不起作用。

活动

名称描述类型
尺寸变化page-size改变时触发功能
当前变化current-page 更改时触发功能
改变 2.4.4current-pagepage-size 更改时触发功能
上一个单击单击上一页按钮且当前页面发生更改时触发功能
下一次单击单击下一个按钮且当前页面发生更改时触发功能

WARNING

不推荐使用上述事件(但出于兼容原因仍然支持),更好的选择是使用 v-model 的双向数据绑定。

老虎机

| 名称 | 描述 | | ---- | --------------------------------------- | ------------- | | 默认 | 自定义内容。要使用它,您需要在 layout | 中声明 slot |