提示

① z-paging由 2.1.4 起兼容vue3，请确保已将z-paging更新至v2.1.4或以上版本
② 请将HbuilderX升级到3.3.13.20220314或以上版本

从vue2目迁移到vue3，必须适配的部分

① slot="top" 需要修改为 v-slot:top或#top，并使用template包住：

② slot-scope写法调整：

③ 模块导出写法调整：

其他详见uni-app官方文档：vue2 项目迁移 vue3 (opens new window)

#

---

支持vue3组合式api写法

<template>
    <z-paging ref="paging" v-model="dataList" @query="queryList">
		<view class="item" v-for="(item,index) in dataList">
			<view class="item-title">{{item.title}}</view>
		</view>
	</z-paging>
</template>

<script setup>
    import { ref } from 'vue';
    const paging = ref(null)
    const dataList = ref([])
    
    const queryList = (pageNo, pageSize) => {
        // 这里的pageNo和pageSize会自动计算好，直接传给服务器即可
        // 这里的请求只是演示，请替换成自己的项目的网络请求，并在网络请求回调中通过paging.value.complete(请求回来的数组)将请求结果传给z-paging
        request.queryList({ pageNo,pageSize }).then(res => {
        	// 请勿在网络请求回调中给dataList赋值！！只需要调用complete就可以了
            paging.value.complete(res.data.list);
        }).catch(res => {
        	// 如果请求失败写paging.value.complete(false)，会自动展示错误页面
        	// 注意，每次都需要在catch中写这句话很麻烦，z-paging提供了方案可以全局统一处理
        	// 在底层的网络请求抛出异常时，写uni.$emit('z-paging-error-emit');即可
        	paging.value.complete(false);
        })
    }
</script>

<style scoped>
    
</style>

页面滚动模式支持vue3+hooks

<!-- 使用页面滚动示例 -->
<template>
	<!-- 此时使用了页面的滚动，z-paging不需要有确定的高度，use-page-scroll需要设置为true -->
	<z-paging ref="paging" v-model="dataList" use-page-scroll @query="queryList">
		<!-- 如果希望其他view跟着页面滚动，可以放在z-paging标签内 -->
		<view class="item" v-for="(item,index) in dataList" :key="index">
			<view class="item-title">{{item.title}}</view>
		</view>
	</z-paging>
</template>

<script setup>
	import { ref } from 'vue';
	 必须导入需要用到的页面生命周期（即使在当前页面上没有直接使用到）
	import { onPageScroll, onReachBottom } from '@dcloudio/uni-app';
	import useZPaging from "@/uni_modules/z-paging/components/z-paging/js/hooks/useZPaging.js";
	
    const paging = ref(null)
	
    const dataList = ref([])
	
	// 类似mixins，如果是页面滚动务必要写这一行，并传入当前ref绑定的paging，注意此处是paging，而非paging.value
	useZPaging(paging)
	
	// 其他省略
</script>