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
甚至我们都不用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.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 | 上拉加载和下拉刷新探索分享到此就结束了,感谢您的阅读。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。
如需转载请保留出处:https://bianchenghao.cn/21522.html