uni-app 下拉刷新

官方文档

https://uniapp.dcloud.io/api/ui/pulldown

onPullDownRefresh

https://uniapp.dcloud.io/api/ui/pulldown?id=onpulldownrefresh

在 js 中定义 onPullDownRefresh 处理函数(和onLoad等生命周期函数同级),监听该页面用户下拉刷新事件。

  • 需要在 pages.json 里,找到的当前页面的pages节点,并在 style 选项中开启 enablePullDownRefresh
  • 当处理完数据刷新后,uni.stopPullDownRefresh 可以停止当前页面的下拉刷新。

注意:开启下拉刷新配置可以在全局配置打开也可以在页面配置打开,但是一般不推荐全局配置打开,推荐那个页面需要就在那个页面打开

uni.startPullDownRefresh(OBJECT)

https://uniapp.dcloud.io/api/ui/pulldown?id=startpulldownrefresh

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

OBJECT 参数说明

参数名 类型 必填 说明
success Function 接口调用成功的回调
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success 返回参数说明

参数 类型 说明
errMsg String 接口调用结果

uni.stopPullDownRefresh

https://uniapp.dcloud.io/api/ui/pulldown?id=stoppulldownrefresh

停止当前页面下拉刷新。

使用示例

关闭全局下拉配置

image-20210317111749988

创建页面

如创建 pages/list/list.vue,内容如下

<template>
	<view>
		<view>这是列表页</view>
		<view class="box-item" v-for="item in list">
			{{item}}
		</view>
		<button @click="pullDown">下拉刷新</button>
	</view>
</template>

<script>
	export default {
		data() {
			return {
				list: ['前端','php','UI','测试','大数据','前端','php','UI','测试','大数据']
			}
		},
		onPullDownRefresh () {
			console.log('触发了下拉刷新')
			setTimeout(()=>{
				this.list = ['php','UI','前端','测试','大数据']
				//手动关闭刷新
				uni.stopPullDownRefresh()
			},2000)
		},
		
		methods: {
			//点击刷新
			pullDown() {
				uni.startPullDownRefresh()
			},
		}
	}
</script>

<style>
</style>

添加页面配置并开启下拉刷新

添加到pages.json中的pages节点中

{
	"path":"pages/list/list",
    "style": {
    	"enablePullDownRefresh": true
    }
},

效果

最开始的状态

image-20210317112908924

鼠标下拉刷新, 手动刷新也是一样的

image-20210317112942100

posted @ 2021-03-17 11:31  makalo  阅读(1566)  评论(0编辑  收藏  举报