Skip to content

Pagination 分页

基于element-plus pagination组件的二次封装。将分页数据直接进行双向绑定,简化事件操作。以下为基本使用,一般搭配表格或列表使用。

基础用法

附加功能

根据场景需要,可以添加其他功能模块。

此示例是一个完整的用例。 使用了 @update:page-size@update:current-page 事件来处理页码大小和当前页变动时候触发的事件。 page-sizes 接受一个整数类型的数组,数组元素为展示的选择每页显示个数的选项,[10, 20, 50, 100, 200] 表示5个选项,每页显示 10 个,20 个,50 个,100个或者200 个。

属性

属性名说明类型是否拓展默认值
v-model:page-size每页显示条目个数number-
v-model:page-current当前页数number-
size el^2.7.6单选框的尺寸enumdefault
background是否为分页按钮添加背景色booleanfalse
default-page-size每页默认的条目个数,不设置时默认为10number-
total总条目数number0
page-count总页数, totalpage-count 设置任意一个就可以达到显示页码的功能;如果要支持 page-sizes 的更改,则需要使用 total 属性number
pager-count设置最大页码按钮数。 页码按钮的数量,当总页数超过该值时会折叠enum7
default-current-page当前页数的默认初始值,不设置时默认为 1number-
layout组件布局,子组件名用逗号分隔enumtotal, sizes, prev, pager, next, jumper
page-sizes每页显示个数选择器的选项设置number[][10, 20, 50, 100]
popper-class每页显示个数选择器的下拉框类名string''
prev-text替代图标显示的上一页文字string''
prev-icon上一页的图标, 比 prev-text 优先级更高enumArrowLeft
next-text替代图标显示的下一页文字string''
next-icon下一页的图标, 比 next-text 优先级更低enumArrowRight
disabled是否禁用分页booleanfalse
teleported是否将下拉菜单teleport至 bodybooleantrue
hide-on-single-page是只有一页时是否隐藏booleanfalse

事件

事件名说明类型是否拓展
update:page-size监听每页显示条目个数变更Function
update:current-page监听当前页数变更Function

基于 MIT 许可发布