更新记录

0.3.6（2025-08-07） 下载此版本

1.新增 添加编译到鸿蒙Next的支持。
2.新增 @query新增from(触发来源)参数。
3.新增 slot=loading加载中插槽。
4.修复 在部分安卓平台数据为空时可能出现的Java数组越界的报错。
5.修复 在iOS平台下拉刷新箭头未变化的问题。
6.修复 refresherEnabled=false时下拉刷新报错的问题。
7.优化 修改下拉刷新和底部加载更多状态枚举类型为字符串类型。
8.优化 下拉刷新显示最后更新时间高度判断逻辑。

0.3.2（2025-02-13） 下载此版本

1.新增 添加编译到微信小程序的支持。
2.优化 在web平台刷新列表是【点击加载更多】闪动然后消失的问题。
3.优化 其他细节调整。

0.3.1（2024-12-03） 下载此版本

1.新增 events：@refresherpulling、@refresherrefresh、@refresherrestore、@refresherabort、@scrolltolower、@scrolltoupper、@refresherStatusChange、@loadMoreStatusChange。
2.新增 slot="empty"。
3.新增 scrollToTop、scrollToBottom、scrollToY添加是否展示滚动动画参数。

平台兼容性

uni-app x(4.07)

其他

z-paging-x

请注意，此插件仅支持uniappx！！！若您为uniapp项目请使用z-paging！

z-paging uniapp x版

反馈qq群(点击加群)：114310688

z-paging-x文档

安装

方式1(推荐)：通过uni_modules安装，在插件市场中点击右上角【使用HbuilderX导入插件】即可。

方式2：通过npm安装

//若项目之前未使用npm管理依赖（项目根目录下无package.json文件），先在项目根目录执行命令初始化npm工程
npm init -y

// 安装
npm install z-paging-x --save
// 更新
npm update z-paging-x

基本使用

<template>
    <z-paging-x ref="pagingX" v-model="dataList" @query="queryList">
        <template #top>
            <common-tabs :list="tabList" @change="tabChange" />
        </template>
        <list-item v-for="(item, index) in dataList" :key="index">
            <view class="list-item">
                <text class="list-item-title">{{item.title}}</text>
                <text class="list-item-type">{{item.detail}}</text>
            </view>
        </list-item>
    </z-paging-x>
</template>

<script lang="uts">
    import { requestList, ListItem } from '@/http/request.uts'
    export default {
        data() {
            return {
                tabList: ['测试1','测试2','测试3','测试4'] as Array<string>,
                tabIndex: 0,
                dataList: [] as Array<ListItem>
            }
        },
        methods: {
            tabChange(index: number) {
                this.tabIndex = index;
                // 刷新列表数据
                (this.$refs['pagingX'] as ZPagingXComponentPublicInstance).reload();
            },
            // @query所绑定的方法不要自己调用！！需要刷新列表数据时，只需要调用(this.$refs['pagingX'] as ZPagingXComponentPublicInstance).reload()即可
            queryList(pageNo: number, pageSize: number) {
                const params = {
                    pageNo: pageNo,
                    pageSize: pageSize,
                    type: this.tabIndex + 1
                }
                // 此处请求仅为演示，请替换为自己项目中的请求
                requestList(params).then((res: UTSJSONObject) => {
                    // 将请求结果通过complete传给z-paging处理，同时也代表请求结束，这一行必须调用
                    (this.$refs['pagingX'] as ZPagingXComponentPublicInstance).complete(res['data'] as any[]);
                })
            }
        }
    }
</script>

props

支持全局配置（非必须）

在main.uts中

import { setZPXConfig } from '@/uni_modules/z-paging-x/components/z-paging-x/config/index.uts'

setZPXConfig({
    //配置分页默认pageSize为15
    'default-page-size': 15,
    //配置空数据图默认描述文字为：空空如也~~
    'empty-text': '空空如也~~',
    //...
});

数据&布局配置

list-view&scroll-view相关配置

reload相关配置

下拉刷新配置

底部加载更多配置

空数据图配置

点击返回顶部配置

events

methods

slots