更新记录
2.8.6(2025-03-17)
下载此版本
1.新增
聊天记录模式流式输出(类似chatGPT回答)演示demo。
2.新增
z-paging及其公共子组件支持HBuilderX
代码文档提示。
3.新增
props:virtual-in-swiper-slot
,用以解决vue3+(微信小程序或QQ小程序)中,使用非内置列表写法时,若z-paging在swiper-item
中存在的无法获取slot插入的cell高度进而导致虚拟列表失败的问题。
4.新增
@scrolltolower
和@scrolltoupper
支持nvue。
5.修复
由v2.8.1
引出的方法scrollIntoViewById
在微信小程序+vue3中无效的问题。
6.修复
由v2.8.1
引出的在子组件内使用z-paging虚拟列表无效的问题。
7.修复
在微信小程序中基础库版本较高时wx.getSystemInfoSync is deprecated
警告。
8.优化
提升下拉刷新在鸿蒙Next中的性能。
9.优化
@scrolltolower
和@scrolltoupper
在倒置的聊天记录模式下的触发逻辑。
10.优化
其他细节调整。
2.8.5(2025-02-09)
下载此版本
1.新增
方法scrollToX
,支持控制x轴滚动到指定位置。
2.修复
快手小程序中报错await isn't allowed in non-async function
的问题。
3.修复
在iOS+nvue中,设置了:loading-more-enabled="false"
后,调用scrollToBottom
无法滚动到底部的问题。
4.修复
在支付宝小程序+页面滚动中,数据为空时空数据图未居中的问题。
5.优化
fetch types修改。
2.8.4(2024-12-02)
下载此版本
1.修复
在虚拟列表+vue2中,顶部占位采用transformY方案;在虚拟列表+vue3中,顶部占位采用view占位方案。以解决在vue2+微信小程序+安卓+兼容模式中,可能出现的虚拟列表闪动的问题。
2.修复
在列表渲染时(尤其是在虚拟列表中)偶现的【点击加载更多】闪现的问题。
3.优化
统一在RefresherStatus枚举中Loading取值。
4.优化
defaultPageNo
&defaultPageSize
修改为只允许number类型。
5.优化
提升兼容性&细节优化。
查看更多
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
HBuilderX 3.0.7 app-vue app-nvue |
√ |
√ |
√ |
√ |
√ |
√ |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
鸿蒙元服务 |
√ |
√ |
√ |
√ |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
z-paging

z-paging-x
现已支持uniapp x,持续完善中,插件地址👉🏻 https://ext.dcloud.net.cn/plugin?name=z-paging-x
更新组件前,请注意版本差异
功能&特点
- 【配置简单】仅需两步(绑定网络请求方法、绑定分页结果数组)轻松完成完整下拉刷新,上拉加载更多功能。
- 【低耦合,低侵入】分页自动管理。在page中无需处理任何分页相关逻辑,无需在data中定义任何分页相关变量,全由z-paging内部处理。
- 【超灵活,支持各种类型自定义】支持自定义下拉刷新,自定义上拉加载更多等各种自定义效果;支持使用内置自动分页,同时也支持通过监听下拉刷新和滚动到底部事件自行处理;支持使用自带全屏布局规范,同时也支持将z-paging自由放在任意容器中。
- 【功能丰富】支持国际化,支持自定义且自动管理空数据图,支持主题模式切换,支持本地分页,支持无闪动聊天分页模式,支持展示最后更新时间,支持吸顶效果,支持内部scroll-view滚动与页面滚动,支持一键滚动到顶部,支持下拉进入二楼等诸多功能。
- 【【全平台兼容】支持vue&nvue,vue2&vue3,js&ts,支持h5、app、鸿蒙Next及各家小程序。
- 【高性能】在app-vue、h5、微信小程序、QQ小程序上使用wxs+renderjs在视图层实现下拉刷新;支持虚拟列表,轻松渲染百万级列表数据!
反馈qq群
预览
自定义下拉刷新效果演示 |
滑动切换选项卡+吸顶演示 |
聊天记录模式演示 |
 |
 |
 |
虚拟列表(流畅渲染1万+条)演示 |
下拉进入二楼演示 |
在弹窗内使用演示 |
 |
 |
 |
在线demo体验地址:
扫码体验 |
 |
demo下载
- 支持vue2&vue3的
选项式api
写法demo下载,请点击页面右上角的【使用HBuilderX导入示例项目】或【下载示例项目ZIP】。
- 支持vue3的
组合式api
写法demo下载,请访问github。