分页
如果一页中显示的数据过多,请使用分页。
基本用法
使用您希望显示的不同分页元素设置 layout,并用逗号分隔。分页元素有:prev(导航到上一页的按钮)、next(导航到下一页的按钮)、pager(页面列表)、jumper(跳转输入)、total(项目总数)、 sizes(确定页面大小的选择)和->(该符号之后的每个元素都将被拉到右侧)。
寻呼机数量
默认情况下,当分页超过 7 页时,分页会折叠额外的分页器按钮。这可以使用 pager-count 属性进行配置。
带背景颜色的按钮
设置 background 属性,按钮将具有背景颜色。
小分页
在空间有限的情况下使用小分页。
设置大小以更改 size。这是small的演示
当只有一页时隐藏分页
当只有一页时,通过设置hide-on-single-page属性隐藏分页。
更多元素
根据您的场景添加更多模块。
此示例是一个完整的用例。它使用size-change和current-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
All combined
Total 400
- 1
- 2
- 3
- 4
API
属性
| 名称 | 描述 | 类型 | 默认 |
|---|---|---|---|
| 大小 2.7.6 | 分页尺寸 | 枚举 | '默认' |
| 背景 | 按钮是否有背景色 | 布尔值 | 假 |
| 页面大小 / v-model:页面大小 | 每页的项目数 | 数字 | — |
| 默认页面大小 | 页面大小默认初始值,不设置与设置10相同 | 数字 | — |
| 总计 | 项目总数 | 数字 | — |
| 页数 | 总页数。设置total或page-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
我们会检测一些已弃用的用法,如果您的分页未按预期显示或工作,请检查以下规则:
- 您必须定义
total和page-count之一,否则我们无法确定总页数。当两者都定义时,page-count优先。 - 如果定义了
current-page,则必须监听current-page的更改,同时定义@update:current-page,否则分页不起作用。 - 如果在显示页面大小选择器时定义了
page-size(sizes包含在layout中),则还必须通过定义@update:page-size来监听page-size的更改,否则页面大小的更改不起作用。
活动
| 名称 | 描述 | 类型 |
|---|---|---|
| 尺寸变化 | 当page-size改变时触发 | 功能 |
| 当前变化 | 当 current-page 更改时触发 | 功能 |
| 改变 2.4.4 | 当 current-page 或 page-size 更改时触发 | 功能 |
| 上一个单击 | 单击上一页按钮且当前页面发生更改时触发 | 功能 |
| 下一次单击 | 单击下一个按钮且当前页面发生更改时触发 | 功能 |
WARNING
不推荐使用上述事件(但出于兼容原因仍然支持),更好的选择是使用 v-model 的双向数据绑定。
老虎机
| 名称 | 描述 | | ---- | --------------------------------------- | ------------- | | 默认 | 自定义内容。要使用它,您需要在 layout | 中声明 slot |