# 版本差异

# 如何查看z-paging版本?

  • 【方式1】展开z-paging文件夹,查看z-paging.vue文件,顶部有注明版本号。
  • 【方式2】通过console.log(this.$refs.paging.getVersion())打印当前版本号。
  • 【方式3】若您的项目使用uni_modules管理,展开uni_modules下的z-paging文件夹,查看其中package.jsonversion字段即为版本号。

说明

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.vuechat-input-bar.vue

# V2.6.5+

  • 由V2.6.5起,【全局配置】在路径@/uni_modules/z-paging下创建z-paging-config.js废弃
  • 由V2.6.5起,【全局配置】在main.jsimport 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起,方法endByTotalCountendByTotalcompleteByTotalCount废弃,由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。