Vue 生态 - 多端解决方案 uni-app

更新时间 2021年0926号

由于本篇文档搜索引擎排名靠前本着替大家解决问题的原则故更新之

这是我的 github github 下文提到的地址可能存在失效

uni app 生态的下拉刷新源代码

<template>
	<!-- <view class="content">
		<image class="logo" src="/static/logo.png"></image>
		<view class="text-area">
			<text class="title">{{title}}</text>
		</view>
		<view class="">
			123
		</view>
	</view> -->
	<view class="content">
		<ItemComp :item="item" v-for="(item,index) in list" :key="index" />
		<!-- 底部文案 -->
		<view class="">
			<text >{{status === 'more' ? contentText.contentdown : (status === 'loading' ? contentText.contentrefresh : contentText.contentnomore)}}</text>
		</view>
	</view>
</template>

<script>
	import ItemComp from '../../components/item.vue'
	
	export default {
		data() {
			return {
				title: 'Hello',
				url:`https://reqres.in/api/users`,
				list:[],
				page:1,
				per_page:10,
				status:'more', // 默认展示上拉显示更多
				contentText:{
					contentdown: "上拉显示更多",
					contentrefresh: "正在加载...",
					contentnomore: "没有更多数据了"
				}
			}
		},
		components:{
			ItemComp
		},
		onShow() {
			this.page =1
			this.per_page = 10
			this.list = []
		},
		onLoad() {
			// 页码归为第1页
			this.page = 1
			// 初始化获取列表数据
			this.fetchData()
		},
		// 下拉刷新触发
		onPullDownRefresh(val){
			this.page = 1
			this.per_page = 10
			console.log('下拉刷新',val)
			this.fetchData().then(()=>{
				uni.stopPullDownRefresh();
			}).catch(err=>{
				uni.stopPullDownRefresh();
				// 弹窗提示
				uni.showToast({
									title: '请求出错了',
									icon: 'none'
								})
			})
		},
		// 上拉加载触发
		onReachBottom(){
			// 改变状态为加载中
			this.status = 'loading'
			// 页码发生变化
			++this.page
			// 加载更多
			this.fetchData('loadMore').then(resArray=>{
				// 此时判断当前有没有请求到数据
				if(resArray.length){
					this.status = 'more'
					
				}else{
					this.status = 'noMore';
					--this.page;
				}
			}).catch(err=>{
				console.log('网络请求失败')
			})
		},
		methods: {
		 	fetchData(way){
				return new Promise((resolve,reject)=>{
					uni.request({
						url:this.url,
						data:{
							page:this.page,
							per_page:this.per_page
						},
						success: (res) => {
							console.log(res)
							// 当页的数据
							const resDataArray = res.data.data
							if(way==='loadMore'){
								this.list = this.list.concat(resDataArray)
							}else{
								this.list = resDataArray
							}
							// 抛出当页的数据
							resolve(resDataArray)
						},
						fail(err) {
							console.log('接口调用失败',err)
							// 抛出异常
							reject()
						}
					})
				})
				
			}
		}
	}
</script>

<style>
	/* .content {
		display: flex;
		flex-direction: column;
		align-items: center;
		justify-content: center;
	} */

	.content{
		width: 100%;
	}
	
</style>

列表页上拉加载更多，下拉刷新效果

轻松实现上拉加载、下拉刷新、返回顶部

实现效果

前期准备

后端接口

在这个小案例中，我们采用开源的jsonplaceholder，这也是我们前端常用的测试接口。为了达到小 demo 的效果暂且使用这个，后续替换为 douban-api

JSONPlaceholder 直接在浏览器就可以

甚至我们都不用mock接口，同时最重要的一点是支持分页查询，查询的参数是

offset
limit

写过后台的应该对这两个字段不陌生，offset 是偏移量的意思，这个在nest官网也有提到

{
    "page":1,
    "limit":10
}

在请求的时候类似是这种，传的页面的信息，不过我们输入的参数

{
    "_offset":xx, // 其中xx 代表的是第几页
    "_limit":xx  // 其中xx 代表的是每页多少条数据
}

下面我们在浏览器地址栏输入（或者使用 postman|postwoman|Vscode 的插件都可） https://jsonplaceholder.typicode.com/posts

返回的结果是：

[
  {
    "userId": 1,
    "id": 1,
    "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
    "body": "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum rerum est autem sunt rem eveniet architecto"
  },
  {
    "userId": 1,
    "id": 2,
    "title": "qui est esse",
    "body": "est rerum tempore vitae\nsequi sint nihil reprehenderit dolor beatae ea dolores neque\nfugiat blanditiis voluptate porro vel nihil molestiae ut reiciendis\nqui aperiam non debitis possimus qui neque nisi nulla"
  },
  {
    "userId": 1,
    "id": 3,
    "title": "ea molestias quasi exercitationem repellat qui ipsa sit aut",
    "body": "et iusto sed quo iure\nvoluptatem occaecati omnis eligendi aut ad\nvoluptatem doloribus vel accusantium quis pariatur\nmolestiae porro eius odio et labore et velit aut"
  }
]
……

那我们在做上拉加载更多最重要的是，页码发生变化，每次

_offset++;

uni-app 网络请求 API

uni-app 官网传送门

在官网上明确指出我们可以通过uni.request(OBJECT),其中传入一个配置对象,值得一提的是默认是GET请求

uni.request({
  url: "https://jsonplaceholder.typicode.com/posts", //请求的地址

  success: res => {
    console.log(res);
  }
});

Item 项

我们知道在前端的开发中，根据后台的list循环生成item项是十分常见的业务需求，那么随之而来的就是上拉加载更多和下拉刷新。那么在这个小的案例中，咱们采用卡片布局。推荐给大家官方在维护的hello-uniapp

github 传送，其中维护了有很多常见的效果。这里我们尽量clone最新的代码，因为它还是更新很频繁的，主要是为了解决一些在不同设备的bug

Do it

异步获取数据

	// 异步获取列表数据
getDataList() {
    uni.request({
        url: 'https://jsonplaceholder.typicode.com/posts', //仅为示例，并非真实接口地址。

        success: (res) => {
                console.log(res)
        }
    });
},

那这样的话是把所有的数据全部获取来，这在实际开发中是不符合规范的

引入插件

一般我们期待在列表数据循环的时候，会有一个下拉刷新以及下拉加载最好还能有回到顶部的效果，这个时候我们采取一个第三方的库，笔者觉得还是十分好用

精致的下拉刷新和上拉加载 js 框架.支持 vue,完美运行于移动端和主流 PC 浏览器 star 数目前是2.8K

它也是可以使用在其他的开发方案中，当然了也是有uniapp的版本,在使用之前，我们先来看一段结构布局部分


	 <mescroll-body ref="mescrollRef" @init="mescrollInit" @down="downCallback" @up="upCallback" :down="downOption" :up="upOption" >
		 <view v-for="(item,index) in dataList" :key="`item${index}`">  </view>
	 </mescroll-body>

其中

属性或方法	含义
ref="mescrollRef"	字节跳动小程序 ref="mescrollRef" 必须配置
@init="mescrollInit"	必须配置
@down="downCallback"	必须配置
@up="upCallback"	必须配置
:down="downOption"	下拉刷新的常用配置
:up="upOption"	上拉加载的常用配置

由于我们在一个项目的很多地方都需要使用到这个效果，那么我们索性，全局引入，注册为全局组件

// 在main.js注册全局组件
import MescrollBody from "@/components/mescroll-uni/mescroll-body.vue";
import MescrollUni from "@/components/mescroll-uni/mescroll-uni.vue";
Vue.component("mescroll-body", MescrollBody);
Vue.component("mescroll-uni", MescrollUni);

pages.json 配置

{
		"path": "pages/findMovie/findMovie",
		"style": {
			"navigationBarTitleText": "找片",
			"enablePullDownRefresh": false,
			"app-plus": {
				"bounce": "none" //删除此项: mescroll-body支持iOS回弹
			}
		}
	},

其中有两个核心的方法

方法	含义
upCallback(page)	上拉加载的回调
downCallback()	下拉刷新的回调

在进行下边部分之前，我们需要知道接口返回的数据的总页数怎么算，也就是说，在接口返回的数据，一般情况下会返回一个total

Math.ceil(5 / 2);
Math.ceil(26 / 10);
Math.ceil(100 / 10);
Math.ceil(20 / 4);

核心代码

/*上拉加载的回调*/
upCallback({num,size}) {
// console.log(num,size) // 1,10
uni.request({
    url: `https://jsonplaceholder.typicode.com/posts`,
    data: {
        _offset: num,
        _limit: size
    },
    success: (data) => {
        // 接口返回的当前页数据列表 (数组)
        let curPageData = data.data;
        // 接口返回的当前页数据长度 (如列表有26个数据,当前页返回8个,则curPageLen=8)
        let curPageLen = data.data.length;
        // 接口返回的总页数 (如列表有26个数据,每页10条,共3页; 则totalPage=3)
        let totalPage = Math.ceil(100/size); // 向上取正
        // 接口返回的总数据量(如列表有26个数据,每页10条,共3页; 则totalSize=26)
        let totalSize = 100;
        // 接口返回的是否有下一页 (true/false)
        // let hasNext = data.xxx;

        //设置列表数据
        if (this.mescroll.num == 1) this.dataList = []; //如果是第一页需手动置空列表
        this.dataList = this.dataList.concat(curPageData); //追加新数据

        // 请求成功,隐藏加载状态
        //方法一(推荐): 后台接口有返回列表的总页数 totalPage
        this.mescroll.endByPage(curPageLen, totalPage);

        //方法二(推荐): 后台接口有返回列表的总数据量 totalSize
        //this.mescroll.endBySize(curPageLen, totalSize);

        //方法三(推荐): 您有其他方式知道是否有下一页 hasNext
        //this.mescroll.endSuccess(curPageLen, hasNext);
    },
    fail: () => {
        //  请求失败,隐藏加载状态
        this.mescroll.endErr()
    }
})
},

写在最后

关于uniapp-douban-movie 这个项目是笔者持续更新维护的一份基于 Vue 生态的多终端解决方案uniapp的个人练手项目，一些在实际开发中遇到的需求会在这个小项目梳理有几点特性

更新时间不确定
代码会同步 github
尽可能模仿豆瓣电影的UI

模块

效果名字	其他
项目中，列表页上拉加载更多，下拉刷新效果

如果感觉挺好玩，不妨给个星星 代码同步在这里

Although it is over, thank you

uni-app | 上拉加载和下拉刷新探索