# Pagination-v2 分页 🎉 V2.5.3

TIP

为什么新增 Pagination-v2 组件?

Pagination-v2 是为兼容基于 Element UI 的分页组件而新增的版本。由于现有分页组件在交互逻辑或行为细节上与 Element UI 存在差异,为避免迁移成本和行为不一致,Pagination-v2 保留了 Element UI 的使用方式与逻辑处理,支持无缝替换,开发者无需修改现有代码即可使用。

# 代码演示

# API

# Attributes

参数 说明 类型 可选值 默认值
small 是否使用小型分页样式 boolean false
background 是否为分页按钮添加背景色 boolean true
page-size 每页显示条目个数,支持 .sync 修饰符 number 10
total 总条目数 number/string
page-count 总页数,total 和 page-count 设置任意一个就可以达到显示页码的功能;如果要支持 page-sizes 的更改,则需要使用 total 属性 Number
pager-count 页码按钮的数量,当总页数超过该值时会折叠 number 大于等于 5 且小于等于 21 的奇数 7
current-page 当前页数,支持 .sync 修饰符 number 1
layout 组件布局,子组件名用逗号分隔 String sizes, prev, pager, next, jumper, ->, total, slot 'prev, pager, next'
page-sizes 每页显示个数选择器的选项设置 number[] [10, 20, 30, 40, 50, 100]
popper-class 每页显示个数选择器的下拉框类名 string
prev-text 替代图标显示的上一页文字 string
next-text 替代图标显示的下一页文字 string
disabled 是否禁用 boolean false
hide-on-single-page 只有一页时是否隐藏 boolean -
before-change 当前页变化之前触发的回调函数(用于拦截除 pageSize 改变外发生的当前页变化) Function

# Events

事件名称 说明 回调参数
size-change pageSize 改变时会触发 每页条数
current-change currentPage 改变时会触发 当前页
prev-click 用户点击上一页按钮改变当前页后触发 当前页
next-click 用户点击下一页按钮改变当前页后触发 当前页

# Slot

name 说明
自定义内容,需要在 layout 中列出 slot
上次更新: 7/7/2025, 11:14:12 AM