Pagination 分页
WebH5
分页。完整模式提供上一页/页码序列(带省略号折叠)/下一页;简洁模式仅上下翻页与输入跳页,移动端视口自动降级为简洁模式。
何时使用
列表/表格数据量较大,需要翻页浏览。
何时不使用
信息流无限滚动场景;数据量小无需分页。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | number | 1 | 当前页码,支持 v-model;越界时按 [1, 总页数] 钳制 |
total | number | 0 | 总条数,与 pageSize 共同决定总页数 |
pageSize | number | 10 | 每页条数 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸;md 页码按钮为 32px 方形 |
simple | boolean | false | 简洁模式:仅 ‹ 输入框/总页数 ›,输入回车跳页(越界钳制);视口 < 768px 时强制启用 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | number | 页码变化时触发,参数为新页码 |
change | number | 页码变化时触发,参数为新页码 |
示例
订单列表分页
示例加载中…
三种尺寸
示例加载中…
简洁模式(移动端友好)
示例加载中…
多页码(省略号折叠)
示例加载中…
事件监听
示例加载中…
Playground
加载中…
md
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Pagination 文档(含手机预览)。