z-paging文档

# 版本差异

# 如何查看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字段即为版本号。

# 不同版本下载

说明

z-paging的所有版本更新都会尽可能兼容低版本写法，更新版本之后可能出现的不兼容之处都会在下方列出。

# V2.8.1+

  • 由V2.8.1起，events和slots中的参数涉及枚举的部分，统一由之前的number类型修改为string类型，展示更直观！涉及的events：@query中的from参数；@refresherStatusChange中的status参数；@loadingStatusChange中的status参数；slot="refresher"中的refresherStatus参数；slot="chatLoading"中的loadingMoreStatus参数。具体请查阅相关events或slots文档。

# 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。