uniapp滚动加载下拉刷新

news2025/4/19 7:23:56

前言

在日常开发中，滚动加载和下拉刷新是非常常见的功能，页面数据过多时，需要滚动加载优化性能，本篇技术分享博客将介绍如何在uniapp中实现滚动加载和下拉刷新。

预览

滚动加载

在这里插入图片描述

下拉刷新

在这里插入图片描述

一、滚动加载

滚动加载指的是当用户滑动页面到底部时，自动加载更多数据。在uniapp中，我们可以通过监onReachBottom来实现滚动加载。

onReachBottom 页面滚动到底部的事件（不是scroll-view滚到底），常用于下拉下一页数据。
onReachBottom使用注意可在pages.json里定义具体页面底部的触发距离onReachBottomDistance，比如设为50，那么滚动页面到距离底部50px时，就会触发onReachBottom事件。

具体实现步骤如下：

声明submitDate对象用来存放接口需要的具体参数，其中page和limit为查询页数和每页查询数据，total为记录数据总条数,pageList存放页面数据。

       data() {
			return {
			    pageList:[],//列表数据
				submitDate: {
					//放你自己的参数
					startDate: '',
					endDate: '',
					page: 1,//页数
					limit: 20//每页条数
				},
				total: 0,//数据总条数
			}
		},

封装数据请求函数

每发起一次请求把获取的数据push到pageList里。

getdata(){
 uni.request({
    url: 'https://www.example.com/request', //仅为示例，并非真实接口地址。
    data:this.submitDate,
    header: {
        'custom-header': 'hello' //自定义请求头信息
    },
    success: (res) => { 
       this.pageList.push(res.data.list); //具体根据你接口返回数据修改
       this.total = res.total;//数据总条数
    }
 });
}

在onReachBottom生命周期里封装具体加载逻辑
① 判断页面数据dataList的长度，如果长度小于total 则继续把数据push到dataList，如果长度大于或者等于total ，则说明已经加载了全部数据，此处提醒用户数据加载完成
② 为了避免数据重复，每滚动到底部一次，在需要请求下一页数据之前，submitDate里page需要加1，即that.submitDate.page++;
如果需要加载框的话，可以在getdata里使用uni.showLoading({title:'加载中...'}),然后在success回调里隐藏加载框 uni.hideLoading()

showLoading参数说明

       onReachBottom() {
			let that = this
			if (that.total <= that.dataList.length) {
				uni.showToast({
					title: '已加载全部数据',
					icon: "none"
				});
			} else {
				that.submitDate.page++;
				that.getData()
			}
		},

二、下拉刷新

下拉刷新指的是当用户下拉页面时，自动刷新页面并重新加载数据。在uniapp中，我们可以通过onPullDownRefresh来实现下拉刷新。

onPullDownRefresh（下拉刷新）

开始下拉刷新，调用后触发下拉刷新动画，效果与用户手动下拉刷新一致。

uni.startPullDownRefresh(OBJECT)参数说明

在这里插入图片描述

uni.stopPullDownRefresh()

停止当前页面下拉刷新。这个一定别忘了，不然页面顶部一直会有一个加载动画

在 js 中定义 onPullDownRefresh 处理函数（和onLoad等生命周期函数同级），监听该页面用户下拉刷新事件。
需要在 pages.json 里，找到的当前页面的pages节点，并在 style 选项中设置 “enablePullDownRefresh”: true。

当处理完数据刷新后，uni.stopPullDownRefresh 可以停止当前页面的下拉刷新。

具体实现步骤如下：

在pages.json下添加 “enablePullDownRefresh”: true
在下拉刷新生命周期里封装相应刷新逻辑

刷新之前先清空页面数据 that.dataList = []; 然后初始化page为查询第一页数据 that.submitDate.page = 1，最后发起请求。

       onPullDownRefresh() {
			let that = this
			that.dataList = [];//清空页面数据
			that.submitDate.page = 1;//初始查询页数
			that.getData()
			setTimeout(function() {
				uni.stopPullDownRefresh();//停止页面加载动画
			}, 1000);
		},