更新记录

0.2.1（2024-03-10）

1.新增 scroll-to-top-when-reload和clean-list-when-reload，支持控制reload时是否自动滚动到顶部&reload时是否立即自动清空原list。
2.修复 在HBuilderX4.0+ 中loading动画失效的问题。
3.修复 分页加载到没有更多数据后下拉刷新，底部依然为没有更多状态的问题。
4.修复 在HBuilderX4.0+ 中点击返回顶部按钮展示异常的问题。
5.优化 reload自动清空列表；滑动切换选项卡支持下拉刷新。

0.2.0（2024-02-02）

支持HBuilder X 4.0

0.1.5（2024-01-22）

1.新增 方法：completeByTotal，支持通过total判断是否有更多数据。
2.新增 方法：completeByNoMore，支持自行判断是否有更多数据。
3.新增 demo：空数据图&加载失败。
4.新增 z-paging-x logo&更新首页导航栏。

平台兼容性

z-paging-x

z-paging uniapp x版

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

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