跳到主要内容

Pagination 分页 ​

WebH5

分页。完整模式提供上一页/页码序列(带省略号折叠)/下一页;简洁模式仅上下翻页与输入跳页,移动端视口自动降级为简洁模式。

何时使用 ​

列表/表格数据量较大,需要翻页浏览。

何时不使用 ​

信息流无限滚动场景;数据量小无需分页。

Props ​

名称类型默认值说明
modelValuenumber1当前页码,支持 v-model;越界时按 [1, 总页数] 钳制
totalnumber0总条数,与 pageSize 共同决定总页数
pageSizenumber10每页条数
sizestring:'sm' | 'md' | 'lg'"md"尺寸;md 页码按钮为 32px 方形
simplebooleanfalse简洁模式:仅 ‹ 输入框/总页数 ›,输入回车跳页(越界钳制);视口 < 768px 时强制启用

Events ​

名称载荷说明
update:modelValuenumber页码变化时触发,参数为新页码
changenumber页码变化时触发,参数为新页码

示例 ​

订单列表分页 ​

示例加载中…

三种尺寸 ​

示例加载中…

简洁模式(移动端友好) ​

示例加载中…

多页码(省略号折叠) ​

示例加载中…

事件监听 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Pagination 文档(含手机预览)。