# 版本差异
# 如何查看z-paging版本?
- 【方式1】展开
z-paging
文件夹,查看z-paging.vue
文件,顶部有注明版本号。 - 【方式2】通过
console.log(this.$refs.paging.getVersion())
打印当前版本号。 - 【方式3】若您的项目使用
uni_modules
管理,展开uni_modules
下的z-paging
文件夹,查看其中package.json
的version
字段即为版本号。
# 不同版本下载
- npm方式安装可直接指定
z-paging
版本 - 非npm安装请查阅 Release (opens new window)
说明
z-paging
的所有版本更新都会尽可能兼容低版本写法,更新版本之后可能出现的不兼容之处都会在下方列出。
# V2.7.0+
- 由V2.7.0起,将vue中的聊天记录模式与nvue中对齐,完全解决了聊天记录模式滚动到顶部加载更多在vue中抖动的问题,同时将聊天记录模式键盘自动弹出自动上推页面交由
z-paging
处理,解决了由此引发的各种问题,尤其是在微信小程序中导航栏被键盘顶出屏幕外的问题。如果您使用了z-paging
的聊天记录模式,强烈建议更新!
⚠️ 写法有一定变更,在chat-history-demo.vue
中主要为去除了聊天记录模式use-page-scroll
配置、去除了cell需要添加:id="z-paging-${index}"
的要求、新增cell需要添加style="transform: scaleY(-1)"
的要求;
⚠️ 在chat-input-bar.vue
中新增了:adjust-position="false"
的配置,防止键盘弹窗自动上顶,交由z-paging
内部处理。
⚠️ 在具体请下载示例项目查看chat-history-demo.vue
和chat-input-bar.vue
。
# V2.6.5+
- 由V2.6.5起,【全局配置】
在路径@/uni_modules/z-paging下创建z-paging-config.js
废弃 - 由V2.6.5起,【全局配置】在
main.js
中import zConfig from '@/uni_modules/z-paging/components/z-paging/js/z-paging-config'
(此路径为使用uni_modules情况下使用,可依照具体情况进行修改),然后进行z-paging的全局配置:zConfig.setConfig(xxx)
废弃 - 新方案可参见👉🏻 全局配置
# V2.5.1+
- 由V2.5.1起,方法
end
废弃,由complete
代替 - 由V2.5.1起,方法
endByTotalCount
、endByTotal
、completeByTotalCount
废弃,由completeByTotal
代替 - 由V2.5.1起,方法
endByNoMore
废弃,由completeByNoMore
代替 - 由V2.5.1起,方法
endByKey
废弃,由completeByKey
代替 - 由V2.5.1起,方法
completeByNoMore
中参数2(必填):是否有更多数据
,修改为是否没有更多数据
,若为true则代表没有更多数据了。与V2.5.1之前相反。
# V2.4.3+
- 由V2.4.3起,旧属性
mounted-auto-call-reload
废弃,由auto
代替) - 由V2.4.3起,旧属性
loading-more-when-no-more-and-inside-of-paging
废弃,由hide-no-more-inside
代替 - 由V2.4.3起,旧属性
hide-loading-more-when-no-more-by-limit
废弃,由hide-no-more-by-limit
代替
# V2.4.1+
- 由V2.4.1起,
z-paging
的i18n配置与uni-app
国际化方案对齐,具体参见i18n配置。
# V2.0.5+
- 由V2.0.5起,
z-paging
的内置下拉刷新z-paging-refresh
和内置滚动到底部加载更多z-paging-load-more
内部view的class和props有所改变。若之前使用/deep/
修改内置下拉刷新或滚动到底部view的样式,更新到此版本及之后的版本,需要进行相关的调整。
# V1.9.0+
- 由V1.9.0起,
fixed
属性默认值为true,z-paging
默认会铺满屏幕。V1.9.0之前的版本更新请注意,使用侧滑滚动切换选项卡或需要局部使用z-paging
请设置:fixed="false"
。
如果您希望fixed属性默认为false,请参考全局配置,将fixed默认值设置为false。