Uniapp实现下拉刷新的三种方式

作者:百宝袋时间:2026-10-31 19:00:15浏览:446

本文详解Uniapp中实现下拉刷新的三种方案:通过pages.json配置的全局刷新性能最佳;利用scroll-view组件实现局部刷新需注意兼容性与refressher-triggered属性;针对嵌套组件场景,介绍如何在父页面onPullDownRefresh中调用子组件方法完成刷新。

在小程序和H5开发中,下拉刷新是一项常见功能。本文主要介绍三种实现该功能的方法:全局下拉刷新、组件局部下拉刷新以及嵌套组件中的下拉刷新。

全局下拉刷新

这种方式实现简单且性能较好,因此最为推荐。具体操作步骤如下:

配置pages.json(在需要该功能的页面设置对应属性)

{
    "pages": [
        {
            "path": "pages/index/index",
            "style": {
                "enablePullDownRefresh": true,
               // 下拉 loading 的样式,可选值为 'dark' 或 'light'
                "backgroundTextStyle": "dark"
            }
        }
    ]
}

在页面中监听下拉刷新事件(使用onPullDownRefresh生命周期函数)

<template>
    <view>
        <!-- 页面内容 -->
    </view>
</template>
 
<script>
export default {
    onPullDownRefresh() {
        // 模拟异步请求数据
        setTimeout(() => {
            // 这里可以编写刷新数据的逻辑,比如重新请求接口获取最新数据
            console.log('下拉刷新完成');
            // 停止下拉刷新动画
            uni.stopPullDownRefresh();
        }, 2000);
    }
};
</script>

scroll-view 组件局部下拉刷新

  • 在scroll-view 组件中,提供了自定义下拉刷新的属性及相关方法供直接使用。不过,其性能表现不如全局下拉刷新,且scroll-view 组件停止下拉刷新的方法可能存在兼容性问题,导致无法正常使用。此时,可以通过refressher-triggered属性来控制下拉刷新的状态。
  • 注意:scroll-view属于区域滚动,不会触发页面级别的滚动,因此无法触发pages.json配置的全局下拉刷新、页面触底onReachBottomDistance以及titleNView的transparent透明渐变效果。

全局下拉刷新

全局下拉刷新

使用示例

<template>
    <scroll-view
        scroll-y
        refresher-enabled
        @refresherrefresh="onRefresh"
        @refresherrestore="onRestore"
        @refresherabort="onAbort"
    >
        <!-- 滚动内容 -->
        <view v-for="item in list" :key="item.id">{{ item.name }}</view>
    </scroll-view>
</template>
 
<script>
export default {
    data() {
        return {
            list: [
                { id: 1, name: 'Item 1' },
                { id: 2, name: 'Item 2' },
                { id: 3, name: 'Item 3' }
            ]
        };
    },
    methods: {
        onRefresh() {
            // 模拟异步请求数据
            setTimeout(() => {
                // 这里可以编写刷新数据的逻辑,比如重新请求接口获取最新数据
                console.log('局部下拉刷新完成');
                // 停止下拉刷新动画
                this.$refs.scrollViewRef.finishPullToRefresh();
            }, 2000);
        },
        onRestore() {
            console.log('下拉刷新被复位');
        },
        onAbort() {
            console.log('下拉刷新被中止');
        }
    }
};
</script>

嵌套组件中的下拉刷新

场景:需要在子组件中触发下拉刷新功能,但在pages.json中只能配置父页面的下拉刷新属性。

父组件配置全局下拉刷新

在page.json中为父页面配置enablePullDownRefresh为true,并在父组件的onPullDownRefresh生命周期函数中调用子组件的刷新方法。

<template>
    <view>
        <!-- 其他内容 -->
        <child-component ref="childRef"></child-component>
    </view>
</template>
 
<script>
import ChildComponent from './ChildComponent.vue';
 
export default {
    components: {
        ChildComponent
    },
    onPullDownRefresh() {
        console.log('父页面触发下拉刷新');
        // 调用子组件的刷新方法
        this.$refs.childRef.refreshData().then(() => {
            // 停止下拉刷新动画
            uni.stopPullDownRefresh();
        }).catch((error) => {
            console.error('刷新数据出错:', error);
            uni.stopPullDownRefresh();
        });
    }
};
</script>

子组件定义刷新方法

<template>
    <!-- 子组件内容 -->
</template>
 
<script>
export default {
    methods: {
        async refreshData() {
            console.log('子组件开始刷新数据');
            // 这里编写刷新数据的逻辑,比如重新请求接口获取最新数据
            try {
                // 调用获取消息的方法
                await this.getData();
                console.log('子组件数据刷新完成');
            } catch (error) {
                console.error('子组件刷新数据出错:', error);
                throw error;
            }
        },
        // 其他方法...
    }
};
</script>

到此这篇关于Uniapp实现下拉刷新的三种方式的文章就介绍到这了,更多相关Uniapp下拉刷新内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!

作者最新文章