z-paging.vue 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353
  1. <!-- _
  2. ____ _ __ __ _ __ _(_)_ __ __ _
  3. |_ /____| '_ \ / _` |/ _` | | '_ \ / _` |
  4. / /_____| |_) | (_| | (_| | | | | | (_| |
  5. /___| | .__/ \__,_|\__, |_|_| |_|\__, |
  6. |_| |___/ |___/
  7. v2.3.2 (2022-06-21)
  8. by ZXLee
  9. -->
  10. <!-- API文档地址:https://z-paging.zxlee.cn -->
  11. <!-- github地址:https://github.com/SmileZXLee/uni-z-paging -->
  12. <!-- dcloud地址:https://ext.dcloud.net.cn/plugin?id=3935 -->
  13. <!-- 反馈QQ群:790460711 -->
  14. <template name="z-paging">
  15. <!-- #ifndef APP-NVUE -->
  16. <view :class="!usePageScroll&&fixed?'z-paging-content z-paging-content-fixed':'z-paging-content'" :style="[finalPagingStyle]">
  17. <!-- #ifndef APP-PLUS -->
  18. <view v-if="cssSafeAreaInsetBottom===-1" class="zp-safe-area-inset-bottom"></view>
  19. <!-- #endif -->
  20. <!-- 顶部固定的slot -->
  21. <slot v-if="!usePageScroll&&$slots.top" name="top" />
  22. <view class="zp-page-top" v-else-if="usePageScroll&&$slots.top" :style="[{'top':`${windowTop}px`,'z-index':topZIndex}]">
  23. <slot name="top" />
  24. </view>
  25. <view :class="{'zp-view-super':true,'zp-scroll-view-super':!usePageScroll}" :style="[finalScrollViewStyle]">
  26. <view v-if="$slots.left" :class="{'zp-page-left':true,'zp-absoulte':finalIsOldWebView}">
  27. <slot name="left" />
  28. </view>
  29. <view :class="{'zp-scroll-view-container':true,'zp-absoulte':finalIsOldWebView}" :style="[scrollViewContainerStyle]">
  30. <scroll-view
  31. ref="zp-scroll-view" :class="{'zp-scroll-view':true,'zp-scroll-view-absolute':!usePageScroll,'zp-scroll-view-hide-scrollbar':!showScrollbar}"
  32. :scroll-top="scrollTop" :scroll-x="scrollX"
  33. :scroll-y="scrollable&&!usePageScroll&&scrollEnable&&(refresherCompleteScrollable?true:refresherStatus!==3)" :enable-back-to-top="finalEnableBackToTop"
  34. :show-scrollbar="showScrollbar" :scroll-with-animation="finalScrollWithAnimation"
  35. :scroll-into-view="scrollIntoView" :lower-threshold="finalLowerThreshold" :upper-threshold="5"
  36. :refresher-enabled="finalRefresherEnabled&&!useCustomRefresher" :refresher-threshold="finalRefresherThreshold"
  37. :refresher-default-style="finalRefresherDefaultStyle" :refresher-background="refresherBackground"
  38. :refresher-triggered="finalRefresherTriggered" @scroll="_scroll" @scrolltolower="_onLoadingMore('toBottom')"
  39. @scrolltoupper="_scrollToUpper" @refresherrestore="_onRestore" @refresherrefresh="_onRefresh(true)">
  40. <view class="zp-paging-touch-view"
  41. <!-- #ifndef APP-VUE || MP-WEIXIN || MP-QQ || H5 -->
  42. @touchstart="_refresherTouchstart" @touchmove="_refresherTouchmove" @touchend="_refresherTouchend" @touchcancel="_refresherTouchend"
  43. <!-- #endif -->
  44. <!-- #ifdef APP-VUE || MP-WEIXIN || MP-QQ || H5 -->
  45. @touchstart="pagingWxs.touchstart" @touchmove="pagingWxs.touchmove" @touchend="pagingWxs.touchend" @touchcancel="pagingWxs.touchend"
  46. @mousedown="pagingWxs.mousedown" @mousemove="pagingWxs.mousemove" @mouseup="pagingWxs.mouseup" @mouseleave="pagingWxs.mouseleave"
  47. <!-- #endif -->
  48. >
  49. <view v-if="finalRefresherFixedBacHeight>0" class="zp-fixed-bac-view" :style="[{'background': refresherFixedBackground,'height': `${finalRefresherFixedBacHeight}px`}]"></view>
  50. <view class="zp-paging-main" :style="[scrollViewInStyle,{'transform': finalRefresherTransform,'transition': refresherTransition}]"
  51. <!-- #ifdef APP-VUE || MP-WEIXIN || MP-QQ || H5 -->
  52. :change:prop="pagingWxs.propObserver" :prop="wxsPropType"
  53. :data-refresherThreshold="finalRefresherThreshold" :data-isIos="isIos"
  54. :data-loading="loading||isRefresherInComplete" :data-useChatRecordMode="useChatRecordMode"
  55. :data-refresherEnabled="refresherEnabled" :data-useCustomRefresher="useCustomRefresher" :data-pageScrollTop="wxsPageScrollTop"
  56. :data-scrollTop="wxsScrollTop" :data-refresherMaxAngle="refresherMaxAngle"
  57. :data-refresherAecc="refresherAngleEnableChangeContinued" :data-usePageScroll="usePageScroll" :data-watchTouchDirectionChange="watchTouchDirectionChange"
  58. :data-oldIsTouchmoving="isTouchmoving" :data-refresherOutRate="finalRefresherOutRate" :data-hasTouchmove="hasTouchmove"
  59. <!-- #endif -->
  60. <!-- #ifdef APP-VUE || H5 -->
  61. :change:renderPropScrollTop="pagingRenderjs.renderPropScrollTopChange" :renderPropScrollTop="renderPropScrollTop"
  62. :change:renderPropUsePageScroll="pagingRenderjs.renderPropUsePageScrollChange" :renderPropUsePageScroll="renderPropUsePageScroll"
  63. <!-- #endif -->
  64. >
  65. <view v-if="showRefresher" class="zp-custom-refresher-view" :style="[{'margin-top': `-${finalRefresherThreshold}px`,'background': refresherBackground}]">
  66. <view class="zp-custom-refresher-container" :style="[{'height': `${finalRefresherThreshold}px`,'background': refresherBackground}]">
  67. <!-- 下拉刷新view -->
  68. <view class="zp-custom-refresher-slot-view">
  69. <slot v-if="!($slots.refresherComplete&&refresherStatus===3)" :refresherStatus="refresherStatus" name="refresher" />
  70. </view>
  71. <slot v-if="$slots.refresherComplete&&refresherStatus===3" name="refresherComplete" />
  72. <z-paging-refresh ref="refresh" v-else-if="!showCustomRefresher" :style="[{'height': `${finalRefresherThreshold}px`}]" :status="refresherStatus"
  73. :defaultThemeStyle="finalRefresherThemeStyle" :defaultText="finalRefresherDefaultText"
  74. :pullingText="finalRefresherPullingText" :refreshingText="finalRefresherRefreshingText" :completeText="finalRefresherCompleteText"
  75. :showUpdateTime="showRefresherUpdateTime" :updateTimeKey="refresherUpdateTimeKey"
  76. :imgStyle="refresherImgStyle" :titleStyle="refresherTitleStyle" :updateTimeStyle="refresherUpdateTimeStyle" />
  77. </view>
  78. </view>
  79. <view class="zp-paging-container">
  80. <slot v-if="useChatRecordMode&&$slots.chatLoading&&loadingStatus!==2&&realTotalData.length" name="chatLoading" />
  81. <view v-else-if="useChatRecordMode&&loadingStatus!==2&&realTotalData.length" class="zp-chat-record-loading-container">
  82. <text v-if="loadingStatus!==1" @click="_scrollToUpper()"
  83. :class="defaultThemeStyle==='white'?'zp-loading-more-text zp-loading-more-text-white':'zp-loading-more-text zp-loading-more-text-black'">{{chatRecordLoadingMoreText}}</text>
  84. <image v-else :src="base64Flower" class="zp-chat-record-loading-custom-image" />
  85. </view>
  86. <!-- 全屏Loading -->
  87. <slot v-if="$slots.loading&&showLoading&&!loadingFullFixed" name="loading" />
  88. <!-- 主体内容 -->
  89. <view class="zp-paging-container-content" :style="[{transform:virtualPlaceholderTopHeight>0?`translateY(${virtualPlaceholderTopHeight}px)`:'none'},finalPagingContentStyle]">
  90. <slot />
  91. <!-- 内置列表&虚拟列表 -->
  92. <template v-if="finalUseInnerList">
  93. <slot name="header"/>
  94. <view class="zp-list-container" :style="[innerListStyle]">
  95. <template v-if="finalUseVirtualList">
  96. <view class="zp-list-cell" :style="[innerCellStyle]" :id="`zp-${item['zp_index']}`" v-for="(item,index) in virtualList" :key="item['zp_unique_index']">
  97. <slot name="cell" :item="item" :index="virtualTopRangeIndex+index"/>
  98. </view>
  99. </template>
  100. <template v-else>
  101. <view class="zp-list-cell" v-for="(item,index) in realTotalData" :key="index">
  102. <slot name="cell" :item="item" :index="index"/>
  103. </view>
  104. </template>
  105. </view>
  106. <slot name="footer"/>
  107. </template>
  108. <view v-if="useVirtualList" class="zp-virtual-placeholder" :style="[{height:virtualPlaceholderBottomHeight+'px'}]"/>
  109. <!-- 上拉加载更多view -->
  110. <!-- #ifndef MP-ALIPAY -->
  111. <slot v-if="showLoadingMoreDefault" name="loadingMoreDefault" />
  112. <slot v-else-if="showLoadingMoreLoading" name="loadingMoreLoading" />
  113. <slot v-else-if="showLoadingMoreNoMore" name="loadingMoreNoMore" />
  114. <slot v-else-if="showLoadingMoreFail" name="loadingMoreFail" />
  115. <z-paging-load-more @doClick="_onLoadingMore('click')" v-else-if="showLoadingMoreCustom" :zConfig="zPagingLoadMoreConfig" />
  116. <!-- #endif -->
  117. <!-- #ifdef MP-ALIPAY -->
  118. <slot v-if="loadingStatus===0&&$slots.loadingMoreDefault&&showLoadingMore&&loadingMoreEnabled&&!useChatRecordMode" name="loadingMoreDefault" />
  119. <slot v-else-if="loadingStatus===1&&$slots.loadingMoreLoading&&showLoadingMore&&loadingMoreEnabled" name="loadingMoreLoading" />
  120. <slot v-else-if="loadingStatus===2&&$slots.loadingMoreNoMore&&showLoadingMore&&showLoadingMoreNoMoreView&&loadingMoreEnabled&&!useChatRecordMode" name="loadingMoreNoMore" />
  121. <slot v-else-if="loadingStatus===3&&$slots.loadingMoreFail&&showLoadingMore&&loadingMoreEnabled&&!useChatRecordMode" name="loadingMoreFail" />
  122. <z-paging-load-more @doClick="_onLoadingMore('click')" v-else-if="showLoadingMore&&showDefaultLoadingMoreText&&!(loadingStatus===2&&!showLoadingMoreNoMoreView)&&loadingMoreEnabled&&!useChatRecordMode" :zConfig="zPagingLoadMoreConfig" />
  123. <!-- #endif -->
  124. <view v-if="safeAreaInsetBottom && useSafeAreaPlaceholder" class="zp-safe-area-placeholder" :style="[{height:safeAreaBottom+'px'}]" />
  125. </view>
  126. <!-- 空数据图 -->
  127. <view :class="{'zp-empty-view':true,'zp-empty-view-center':emptyViewCenter}" :style="[{emptyViewSuperStyle}]" v-if="showEmpty">
  128. <slot v-if="$slots.empty" name="empty" />
  129. <z-paging-empty-view v-else :emptyViewImg="finalEmptyViewImg" :emptyViewText="finalEmptyViewText" :showEmptyViewReload="finalShowEmptyViewReload"
  130. :emptyViewReloadText="finalEmptyViewReloadText" :isLoadFailed="isLoadFailed" :emptyViewStyle="emptyViewStyle" :emptyViewTitleStyle="emptyViewTitleStyle"
  131. :emptyViewImgStyle="emptyViewImgStyle" :emptyViewReloadStyle="emptyViewReloadStyle" :emptyViewZIndex="emptyViewZIndex" :emptyViewFixed="emptyViewFixed"
  132. @reload="_emptyViewReload" />
  133. </view>
  134. </view>
  135. </view>
  136. </view>
  137. </scroll-view>
  138. </view>
  139. <view v-if="$slots.right" :class="{'zp-page-right':true,'zp-absoulte zp-right':finalIsOldWebView}">
  140. <slot name="right" />
  141. </view>
  142. </view>
  143. <!-- 底部固定的slot -->
  144. <slot v-if="!usePageScroll&&$slots.bottom" name="bottom" />
  145. <view class="zp-page-bottom" v-else-if="usePageScroll&&$slots.bottom" :style="[{'bottom': `${windowBottom}px`}]">
  146. <slot name="bottom" />
  147. </view>
  148. <!-- 点击返回顶部view -->
  149. <view v-if="showBackToTopClass" :class="backToTopClass" :style="[finalBackToTopStyle]" @click.stop="_backToTopClick">
  150. <slot v-if="$slots.backToTop" name="backToTop" />
  151. <image v-else class="zp-back-to-top-img" :src="backToTopImg.length?backToTopImg:base64BackToTop" />
  152. </view>
  153. <!-- 全屏Loading(铺满z-paging并固定) -->
  154. <view v-if="$slots.loading&&showLoading&&loadingFullFixed" class="zp-loading-fixed">
  155. <slot name="loading" />
  156. </view>
  157. </view>
  158. <!-- #endif -->
  159. <!-- #ifdef APP-NVUE -->
  160. <view :is="finalNvueSuperListIs" :style="[finalPagingStyle]" :class="{'z-paging-content-fixed':fixed&&!usePageScroll}" :scrollable="false">
  161. <!-- 顶部固定的slot -->
  162. <view ref="zp-page-top" :is="nViewIs" class="zp-page-top" v-if="$slots.top" :style="[{'top':`${windowTop}px`,'z-index':topZIndex}]">
  163. <slot name="top" />
  164. </view>
  165. <view :is="finalNvueSuperListIs" class="zp-n-list-container" :scrollable="false">
  166. <view v-if="$slots.left" class="zp-page-left" :style="[{'marginTop':scrollViewStyle.marginTop,'marginBottom':scrollViewStyle.marginBottom}]">
  167. <slot name="left" />
  168. </view>
  169. <view ref="zp-n-list" :id="nvueListId" :style="[{'flex': 1,'top':isIos?'0px':'-1px'},scrollViewStyle,useChatRecordMode ? {transform: nIsFirstPageAndNoMore?'rotate(0deg)':'rotate(180deg)'}:{}]" :is="finalNvueListIs" alwaysScrollableVertical="true"
  170. :fixFreezing="nFixFreezing" :show-scrollbar="showScrollbar&&!useChatRecordMode" :loadmoreoffset="finalLowerThreshold" :enable-back-to-top="enableBackToTop"
  171. :scrollable="scrollable&&scrollEnable&&(refresherCompleteScrollable?true:refresherStatus!==3)" :bounce="nvueBounce" :column-count="nWaterfallColumnCount" :column-width="nWaterfallColumnWidth"
  172. :column-gap="nWaterfallColumnGap" :left-gap="nWaterfallLeftGap" :right-gap="nWaterfallRightGap" :pagingEnabled="nvuePagingEnabled"
  173. @loadmore="_nOnLoadmore" @scroll="_nOnScroll">
  174. <refresh class="zp-n-refresh" :style="[nvueRefresherStyle]" v-if="finalNvueRefresherEnabled" :display="nRefresherLoading?'show':'hide'" @refresh="_nOnRrefresh" @pullingdown="_nOnPullingdown">
  175. <view ref="zp-n-refresh-container" class="zp-n-refresh-container" :style="[{background:refresherBackground,width:nRefresherWidth}]" id="zp-n-refresh-container">
  176. <!-- 下拉刷新view -->
  177. <slot v-if="zScopedSlots.refresherComplete&&refresherStatus===3" name="refresherComplete" />
  178. <slot v-else-if="zScopedSlots.refresher" :refresherStatus="refresherStatus" name="refresher" />
  179. <z-paging-refresh ref="refresh" v-else :status="refresherStatus" :defaultThemeStyle="finalRefresherThemeStyle"
  180. :defaultText="finalRefresherDefaultText" :pullingText="finalRefresherPullingText" :refreshingText="finalRefresherRefreshingText" :completeText="finalRefresherCompleteText"
  181. :showUpdateTime="showRefresherUpdateTime" :updateTimeKey="refresherUpdateTimeKey"
  182. :imgStyle="refresherImgStyle" :titleStyle="refresherTitleStyle" :updateTimeStyle="refresherUpdateTimeStyle" />
  183. </view>
  184. </refresh>
  185. <view ref="zp-n-list-top-tag" class="zp-n-list-top-tag" style="margin-top: -1rpx;" :style="[{height:finalNvueRefresherEnabled?'0px':'1px'}]" :is="nViewIs"></view>
  186. <view v-if="nShowRefresherReveal" ref="zp-n-list-refresher-reveal" :style="[{transform:`translateY(-${nShowRefresherRevealHeight}px)`,height:'0px'},{background:refresherBackground}]" :is="nViewIs">
  187. <!-- 下拉刷新view -->
  188. <slot v-if="zScopedSlots.refresherComplete&&refresherStatus===3" name="refresherComplete" />
  189. <slot v-else-if="zScopedSlots.refresher" :refresherStatus="refresherStatus" name="refresher" />
  190. <z-paging-refresh ref="refresh" v-else :status="refresherStatus" :defaultThemeStyle="finalRefresherThemeStyle"
  191. :defaultText="finalRefresherDefaultText" :pullingText="finalRefresherPullingText" :refreshingText="finalRefresherRefreshingText" :completeText="finalRefresherCompleteText"
  192. :showUpdateTime="showRefresherUpdateTime" :updateTimeKey="refresherUpdateTimeKey"
  193. :imgStyle="refresherImgStyle" :titleStyle="refresherTitleStyle" :updateTimeStyle="refresherUpdateTimeStyle" />
  194. </view>
  195. <template v-if="finalUseInnerList">
  196. <view :is="nViewIs">
  197. <slot name="header"/>
  198. </view>
  199. <view class="zp-list-cell" :is="nViewIs" v-for="(item,index) in realTotalData" :key="finalCellKeyName.length?item[finalCellKeyName]:index">
  200. <slot name="cell" :item="item" :index="index"/>
  201. </view>
  202. <view :is="nViewIs">
  203. <slot name="footer"/>
  204. </view>
  205. </template>
  206. <template v-else>
  207. <slot />
  208. </template>
  209. <!-- 全屏Loading -->
  210. <view :class="{'z-paging-content-fixed':usePageScroll}" style="flex: 1;" :style="[useChatRecordMode ? {transform: nIsFirstPageAndNoMore?'rotate(0deg)':'rotate(180deg)'}:{}]" v-if="$slots.loading&&showLoading&&!loadingFullFixed" :is="nViewIs">
  211. <slot name="loading" />
  212. </view>
  213. <!-- 空数据图 -->
  214. <view class="z-paging-empty-view" :class="{'z-paging-content-fixed':usePageScroll}" style="flex: 1;" :style="[emptyViewSuperStyle,useChatRecordMode ? {transform: nIsFirstPageAndNoMore?'rotate(0deg)':'rotate(180deg)'}:{}]" v-if="showEmpty" :is="nViewIs">
  215. <view :class="{'zp-empty-view':true,'zp-empty-view-center':emptyViewCenter}">
  216. <slot v-if="$slots.empty" name="empty" />
  217. <z-paging-empty-view v-else :emptyViewImg="finalEmptyViewImg" :emptyViewText="finalEmptyViewText" :showEmptyViewReload="finalShowEmptyViewReload"
  218. :emptyViewReloadText="finalEmptyViewReloadText" :isLoadFailed="isLoadFailed" :emptyViewStyle="emptyViewStyle" :emptyViewTitleStyle="emptyViewTitleStyle"
  219. :emptyViewImgStyle="emptyViewImgStyle" :emptyViewReloadStyle="emptyViewReloadStyle" :emptyViewZIndex="emptyViewZIndex" :emptyViewFixed="emptyViewFixed"
  220. @reload="_emptyViewReload" />
  221. </view>
  222. </view>
  223. <view v-if="!hideNvueBottomTag" ref="zp-n-list-bottom-tag" class="zp-n-list-bottom-tag" is="header"></view>
  224. <!-- 上拉加载更多view -->
  225. <view :is="nViewIs" v-if="!refresherOnly&&loadingMoreEnabled">
  226. <view v-if="useChatRecordMode">
  227. <view v-if="loadingStatus!==2&&realTotalData.length">
  228. <slot v-if="$slots.chatLoading" name="chatLoading" />
  229. <view v-else class="zp-chat-record-loading-container">
  230. <text v-if="loadingStatus!==1" @click="_scrollToUpper()"
  231. :class="defaultThemeStyle==='white'?'zp-loading-more-text zp-loading-more-text-white':'zp-loading-more-text zp-loading-more-text-black'">{{chatRecordLoadingMoreText}}</text>
  232. <view>
  233. <loading-indicator v-if="loadingStatus===1" class="zp-line-loading-image" animating />
  234. </view>
  235. </view>
  236. </view>
  237. </view>
  238. <view :style="nLoadingMoreFixedHeight?{height:loadingMoreCustomStyle&&loadingMoreCustomStyle.height?loadingMoreCustomStyle.height:'80rpx'}:{}">
  239. <slot v-if="showLoadingMoreDefault" name="loadingMoreDefault" />
  240. <slot v-else-if="showLoadingMoreLoading" name="loadingMoreLoading" />
  241. <slot v-else-if="showLoadingMoreNoMore" name="loadingMoreNoMore" />
  242. <slot v-else-if="showLoadingMoreFail" name="loadingMoreFail" />
  243. <z-paging-load-more @doClick="_onLoadingMore('click')" v-else-if="showLoadingMoreCustom" :zConfig="zPagingLoadMoreConfig" />
  244. <view v-if="safeAreaInsetBottom && useSafeAreaPlaceholder" class="zp-safe-area-placeholder" :style="[{height:safeAreaBottom+'px'}]" />
  245. </view>
  246. </view>
  247. </view>
  248. <view v-if="$slots.right" class="zp-page-right">
  249. <slot name="right" />
  250. </view>
  251. </view>
  252. <!-- 底部固定的slot -->
  253. <slot name="bottom" />
  254. <!-- 点击返回顶部view -->
  255. <view v-if="showBackToTopClass" :class="backToTopClass" :style="[finalBackToTopStyle]" @click.stop="_backToTopClick">
  256. <slot v-if="$slots.backToTop" name="backToTop" />
  257. <image v-else class="zp-back-to-top-img" :src="backToTopImg.length?backToTopImg:base64BackToTop" />
  258. </view>
  259. <!-- 全屏Loading(铺满z-paging并固定) -->
  260. <view v-if="$slots.loading&&showLoading&&loadingFullFixed" class="zp-loading-fixed">
  261. <slot name="loading" />
  262. </view>
  263. </view>
  264. <!-- #endif -->
  265. </template>
  266. <!-- #ifdef APP-VUE || MP-WEIXIN || MP-QQ || H5 -->
  267. <script src="./wxs/z-paging-wxs.wxs" module="pagingWxs" lang="wxs"></script>
  268. <!-- #endif -->
  269. <script module="pagingRenderjs" lang="renderjs">
  270. import pagingRenderjs from './wxs/z-paging-renderjs.js';
  271. /**
  272. * z-paging 分页组件
  273. * @description 高性能,全平台兼容。支持虚拟列表,支持nvue、vue3
  274. * @tutorial https://z-paging.zxlee.cn
  275. * @notice 以下仅为部分常用属性、方法&事件,完整文档请查阅z-paging官网
  276. * @property {Number|String} default-page-no 自定义初始的pageNo,默认为1
  277. * @property {Number|String} default-page-size 自定义pageSize,默认为10
  278. * @property {Number|String} delay 调用complete后延迟处理的时间,单位为毫秒
  279. * @property {String} language i18n国际化设置语言,支持简体中文(zh-cn)、繁体中文(zh-hant-cn)和英文(en)
  280. * @property {Object} paging-style 设置z-paging的style,部分平台(如微信小程序)无法直接修改组件的style,可使用此属性代替
  281. * @property {String} height z-paging的高度,优先级低于pagingStyle中设置的height,传字符串,如100px、100rpx、100%
  282. * @property {String} width z-paging的宽度,优先级低于pagingStyle中设置的width,传字符串,如100px、100rpx、100%
  283. * @property {String} bg-color z-paging的背景色,优先级低于pagingStyle中设置的background。传字符串,如"#ffffff"
  284. * @property {String} default-theme-style loading(下拉刷新、上拉加载更多)的主题样式,支持black,white,默认black
  285. * @property {String} refresher-theme-style 下拉刷新的主题样式,支持black,white,默认black
  286. * @property {Boolean} refresher-only 是否只使用下拉刷新,设置为true后将关闭mounted自动请求数据、关闭滚动到底部加载更多,强制隐藏空数据图。默认为否
  287. * @property {Boolean} use-page-scroll 使用页面滚动,默认为否,当设置为是时则使用页面的滚动而非此组件内部的scroll-view的滚动,使用页面滚动时z-paging无需设置确定的高度且对于长列表展示性能更高,但配置会略微繁琐
  288. * @property {Boolean} use-virtual-list 是否使用虚拟列表,默认为否
  289. * @property {Boolean} fixed z-paging是否使用fixed布局,若使用fixed布局,则z-paging的父view无需固定高度,z-paging高度默认为100%,默认为是(当使用内置scroll-view滚动时有效)
  290. * @property {Boolean} safe-area-inset-bottom 是否开启底部安全区域适配,默认为否
  291. * @property {Boolean} auto [z-paging]mounted后是否自动调用reload方法(mounted后自动调用接口),默认为是
  292. * @property {Boolean} auto-scroll-to-top-when-reload reload时是否自动滚动到顶部,默认为是
  293. * @property {Boolean} auto-clean-list-when-reload reload时是否立即自动清空原list,默认为是,若立即自动清空,则在reload之后、请求回调之前页面是空白的
  294. * @property {Boolean} show-refresher-when-reload 列表刷新时是否自动显示下拉刷新view,默认为否
  295. * @property {String|Object} refresher-default-text 自定义下拉刷新默认状态下的文字
  296. * @property {String|Object} refresher-pulling-text 自定义下拉刷新松手立即刷新状态下的文字
  297. * @property {String|Object} refresher-refreshing-text 自定义下拉刷新刷新中状态下的文字
  298. * @property {String|Object} refresher-complete-text 自定义下拉刷新刷新结束状态下的文字
  299. * @property {Object} loading-more-custom-style 自定义底部加载更多样式
  300. * @property {Boolean} loading-more-enabled 是否启用加载更多数据(含滑动到底部加载更多数据和点击加载更多数据),默认为是
  301. * @property {String|Object} loading-more-default-text 滑动到底部"默认"文字,默认为【点击加载更多】
  302. * @property {String|Object} loading-more-loading-text 滑动到底部"加载中"文字,默认为【正在加载...】
  303. * @property {String|Object} loading-more-no-more-text 滑动到底部"没有更多"文字,默认为【没有更多了】
  304. * @property {String|Object} loading-more-fail-text 滑动到底部"加载失败"文字,默认为【加载失败,点击重新加载】
  305. * @property {Boolean} inside-more 当分页未满一屏时,是否自动加载更多(nvue无效),默认为否
  306. * @property {Boolean} hide-empty-view 是否强制隐藏空数据图,默认为否
  307. * @property {String|Object} empty-view-text 空数据图描述文字,默认为“没有数据哦~”
  308. * @property {Boolean} show-empty-view-reload 是否显示空数据图重新加载按钮(无数据时),默认为否
  309. * @property {Boolean} show-empty-view-reload-when-error 加载失败时是否显示空数据图重新加载按钮,默认为是
  310. * @property {String} empty-view-img 空数据图图片,默认使用z-paging内置的图片
  311. * @property {String|Object} empty-view-reload-text 空数据图点击重新加载文字
  312. * @property {String|Object} empty-view-error-text 空数据图“加载失败”描述文字
  313. * @property {String} empty-view-error-img 空数据图“加载失败”图片,默认使用z-paging内置的图片(建议使用绝对路径)
  314. * @property {Object} empty-view-style 空数据图样式
  315. * @property {Boolean} empty-view-fixed 空数据图片是否铺满z-paging,默认为是。若设置为否,则为填充满z-paging的剩余部分
  316. * @property {Boolean} empty-view-center 空数据图片是否垂直居中,默认为是。emptyViewFixed为false时有效
  317. * @property {Boolean} auto-show-back-to-top 自动显示点击返回顶部按钮,默认为否
  318. * @property {Number|String} back-to-top-threshold 点击返回顶部按钮显示/隐藏的阈值(滚动距离),单位为px,默认为400rpx
  319. * @property {String} back-to-top-img 点击返回顶部按钮的自定义图片地址,默认使用z-paging内置的图片
  320. * @property {Object} back-to-top-style 点击返回顶部按钮的自定义样式
  321. * @property {Boolean} show-scrollbar 控制是否出现滚动条,默认为是
  322. * @property {Number|String} lower-threshold 距底部/右边多远时(单位px),触发 scrolltolower 事件,默认为100rpx
  323. * @property {Boolean} refresher-enabled 是否开启自定义下拉刷新,默认为是
  324. * @property {Boolean} show-refresher-update-time 是否显示上次下拉刷新更新时间,默认为否
  325. * @property {String} refresher-update-time-key 上次下拉刷新更新时间的key,用于区别不同的上次更新时间
  326. * @property {Boolean} use-chat-record-mode 使用聊天记录模式,默认为否
  327. * @property {String} nvue-list-is nvue中修改列表类型,可选值有list、waterfall和scroller,默认为list
  328. * @property {Object} nvue-waterfall-config nvue waterfall配置,仅在nvue中且nvueListIs=waterfall时有效,配置参数详情参见:https://uniapp.dcloud.io/component/waterfall
  329. * @event {Function} query 下拉刷新或滚动到底部时会自动触发此方法。z-paging加载时也会触发(若要禁止,请设置:auto="false")。pageNo和pageSize会自动计算好,直接传给服务器即可。
  330. * @event {Function} refresherStatusChange 自定义下拉刷新状态改变(use-custom-refresher为true时生效)
  331. * @event {Function} loadingStatusChange 上拉加载更多状态改变
  332. * @event {Function} onRefresh 自定义下拉刷新被触发
  333. * @event {Function} scroll `z-paging`内置的scroll-view滚动时触发
  334. * @event {Function} scrolltolower `z-paging`内置的scroll-view滚动底部时触发
  335. * @event {Function} scrolltoupper `z-paging`内置的scroll-view滚动顶部时触发
  336. * @event {Function} listChange 分页渲染的数组改变时触发
  337. * @event {Function} emptyViewReload 点击了空数据图中的重新加载按钮
  338. * @example <z-paging ref="paging" v-model="dataList" @query="queryList"></z-paging>
  339. */
  340. export default {
  341. name:"z-paging",
  342. // #ifdef APP-VUE || H5
  343. mixins: [pagingRenderjs],
  344. // #endif
  345. }
  346. </script>
  347. <script src="./js/z-paging-main.js" />
  348. <style scoped>
  349. @import "./css/z-paging-main.css";
  350. @import "./css/z-paging-static.css";
  351. </style>