Pagination 分页
uni-appH5微信小程序App
跨端分页器,支持当前页、总条数、每页数量和 v-model。
何时使用
列表/表格数据量较大,需要翻页浏览。
何时不使用
信息流无限滚动场景;数据量小无需分页。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | number | 1 | 当前页码,支持 v-model;越界时按 [1, 总页数] 钳制 |
total | number | 0 | 总条数,与 pageSize 共同决定总页数 |
pageSize | number | 10 | 每页条数 |
simple | boolean | false | 简洁模式:仅 ‹ 输入框/总页数 ›,输入回车跳页(越界钳制);视口 < 768px 时强制启用 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸;md 页码按钮为 32px 方形 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | number | 页码变化时触发,参数为新页码 |
change | number | 页码变化时触发,参数为新页码 |
示例
基础用法
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" />