跳到主要内容

Pagination 分页 ​

uni-appH5微信小程序App

跨端分页器,支持当前页、总条数、每页数量和 v-model。

何时使用 ​

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

何时不使用 ​

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

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Pagination 分页 · uni-app H5 实时运行 新窗口打开

Props ​

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

Events ​

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

示例 ​

基础用法 ​

vue
<Pagination v-model="page" :total="120" />

简洁模式 ​

vue
<Pagination v-model="page" :total="120" simple />

大页容量 ​

vue
<Pagination v-model="pg2" :total="200" :page-size="20" />

尺寸 ​

vue
<Pagination v-model="pg3" :total="200" size="sm" />