uniapp小程序开发实战系列,完整介绍从零实现一款影视类小程序。包含小程序前端和后台接口的全部完整实现。系列连载中,喜欢的可以点击收藏。

这里介绍下我的电影小程序的完整实现过程。这个系列将会详细讲解每个步骤,包括接口设计、数据结构优化、用户体验提升等方面,帮助开发者从零开始构建一个完整的电影小程序。希望这个系列对你有所帮助,别忘了点击收藏,以便随时查阅和跟进更新内容。接下来后续的文章,还将深入探讨如何实现电影详情页以及评论功能。

该篇着重介绍下实现过程中的横向滚动和下拉刷新的实现。

电影展示界面,是个明显的横向滚动。在没实现之前,一直以为可能需要借助listView或者uni-grid组件来实现,最后发现都不行。最终仅使用内置组件的scroll-view配合flex布局就完美达到效果啦。这里总结分享下,给需要的小伙伴。

效果截图: 

uniapp小程序开发 | 从零实现一款影视类app (横向滚动和下拉刷新的实现)插图

在uniapp小程序开发中,实现横向滚动和下拉刷新功能是一项常见的需求,尤其是在构建电影展示界面这样的场景。

首先,我们来看看横向滚动的实现。

横向滚动(Horizontal Scrolling)

使用组件,设置scroll-x属性为true,这将使内容在水平方向上滚动。

通过width和height属性控制scroll-view的尺寸,确保内容能正确显示。

为了确保内容宽度大于容器宽度,我们需要通过CSS设置display: flex和flex-wrap: nowrap,这样内容会水平排列并持续滚动。

实现代码

index.vue:


	           
            
				  
					影院热映
				
				
					查看更多 >
				
			
			
			 
			  
			        
			          
			          {{ ellipsis(item.title) }}
					  
					  	
					  	
					  	{{item.rate}}
					  
			        
			    
			  
	

样式代码


	.content {
		display: flex;
		flex-direction: column;
		align-items: center;
		justify-content: center;
	}

	.uni-margin-wrap {
			width: 690rpx;
			width: 100%;
	}
		
	
	.scroll{
		height:320rpx;
		width: 100%;
		white-space: nowrap;
		margin-top:15rpx;
	}
	
	.movie-box{
		display: flex;
		flex-direction: row;
		padding-left: 10rpx;
		padding-right: 10rpx;
	}
	
	.movie-item {
	  display: flex;
	  flex-direction: column;
	  align-items: center;
	  justify-content: center;
	  width: 200rpx;
	  height: 330rpx;
	  margin-right: 22rpx;
	}
	
	.movie-item-img {
		border-radius: 5rpx;
	}

	.movie-item-title {
	  color: #606266;
	  font-size: 10rpx;
	  margin-top: 10rpx;
	}

	.movie-rate {
		height: 40rpx;
		line-height: 40rpx;
		display: flex;
		justify-content: space-between;
		align-items: center;
		margin-bottom: 15rpx;
	}
	
	.movie-rate-t {
		margin-right: 4rpx;
		font-size: 8rpx;
	}

接口实现

以下为测试横向滚动使用的接口,获取正在热映的电影。

// 获取当前正在热映电影
export const getNowHot = async (start,count,city) => {
  try {
	console.log('getNowHot request');
    const response = await uni.$http.post('/movie/in_theaters',{
		apikey: uni.$apiKey,city:city,start:start,count:count});
	
	console.log(response);
    if (response.statusCode !== 200) {
      uni.showToast({
        title: '数据请求失败! ',
        duration: 1500,
        icon: 'none',
      });
      return [];
    }
    return response.data;
  } catch (error) {
    console.error('Network request failed:', error);
    uni.showToast({
      title: '网络请求失败! ',
      duration: 1500,
      icon: 'none',
    });
    return [];
  }
};

接口mock

以下为对今日热映电影的接口的mock(支持分页请求),在后台接口不具备的情况下方便测试。

// 界面A的Mock Data
import './better-mock/mock.mp.js'

export function mockTest(){
	console.log('mockTest')
    // 今日热映 电影接口模拟
	const data2 = Mock.mock(uni.$http.baseUrl+'/movie/in_theaters','post',{
	        // 属性 list 的值是一个数组,其中含有3个元素
	        'list|10': [{
	            'id|+1': 1,
	            'imageUrl|+1': ['/static/hot/1.jpg',
				 '/static/hot/2.jpg', 
				 '/static/hot/3.jpg', 
				 '/static/hot/4.jpg', 
				 '/static/hot/5.jpg', 
				 '/static/hot/6.jpg'],
	            'title|4-6': '标题',
				'rate|1-9':1,
	            'description|2-3':'这是描述'
	        }],
			'total|20-50': 1, 
			'currentPage|1-5': 1, 
			'pageSize': 5
	    });
	// 输出结果
	console.log(JSON.stringify(data2, null, 4));//使用四个空格缩进
}

下拉刷新的实现

在点击查看更多时,会进入今日热映页面,展示全部的热映影片。这时候就用到了下拉刷新的实现,因为数据是分页请求的,一次不可能全部加载完。

uniapp小程序开发 | 从零实现一款影视类app (横向滚动和下拉刷新的实现)插图(1)

下拉刷新,分页加载的实现也很简单。在uniapp中有onReachBottom页面级别的生命周期事件。 

在uniapp中,onReachBottom 是一个页面级别的生命周期事件,当用户滚动到页面底部时触发。它的主要用途是用来实现下拉加载更多(Load More)的功能,即当用户滚动到页面的底部附近,系统自动触发该事件,开发者可以在这个事件的回调函数中加载新的数据并更新列表。

可在pages.json里定义具体页面底部的触发距离onReachBottomDistance,

比如设为50,那么滚动页面到距离底部50px时,就会触发onReachBottom事件。

注意和scroll-view滚动到底部的事件的区别,scroll-view 组件自身的滚动到底部事件与页面级别的 onReachBottom 事件有以下几点区别:

1.触发范围:

scroll-view滚动到底部事件:此事件仅限于组件内部的滚动。当scroll-view的内容滚动到其容器底部时触发。

onReachBottom:这是页面级别的事件,适用于整个页面的滚动。当用户滚动到页面底部时触发,无论滚动发生在scroll-view组件内还是页面的其他可滚动区域。

2.应用场景:

scroll-view滚动到底部事件:适用于那些需要在局部滚动区域(如列表、轮播等)实现加载更多功能的场景。

onReachBottom:适用于整个页面滚动到尽头时加载更多内容,适用于页面主体内容滚动的场景。

3.实现下拉刷新:

实现下拉刷新功能通常不直接使用上述两个事件中的任何一个。下拉刷新通常通过scroll-view组件的refresher-enabled属性和相关事件来实现。

设置scroll-view的refresher-enabled属性为true来开启下拉刷新功能。

使用@refresherpulling事件监听用户下拉动作,可以在此事件中更新下拉刷新的UI状态或显示刷新进度。

使用@refresherrefresh事件处理实际的刷新逻辑,即调用接口获取新数据。

数据加载完成后,调用this.$refs.scrollview.finishPullRefresh()来结束刷新状态。

scrollview的下拉刷新示例代码片段如下:


  

methods: {
  onRefresherPulling(e) {
    // 可以在这里根据e.detail.pullDistance等信息更新下拉刷新的UI
  },
  async onRefresherRefresh() {
    // 加载新数据
    await this.loadData();
    // 结束刷新状态
    this.$refs.scrollview.finishPullRefresh();
  },
  loadData() {
    // 实际的数据加载逻辑
  }
}

 参见文档:页面 | uni-app官网

由于这个展示在单独的一个页面,因此简单的使用页面声明周期事件onReachBottom。

完整代码:


	
		
		
			
				
					
					 {{ ellipsis(item.title) }}
						
							
							
							{{item.rate}}
						
				
			
			
		
	





.wrapper {
		position: absolute;
		top: 0;
		bottom: 0;
		width: 100%;
		background-color: #F4F4F4;
	}
	
	.scroll{
		height:100%;
		width: 100%;
		white-space: nowrap;
		margin-top:10rpx;
	}
	
	.movie-box{
		display: flex;
		flex-direction: row;
		flex-wrap: wrap;
		padding-left: 10rpx;
		padding-right: 10rpx;
	}
	
	.movie-item {
	  display: flex;
	  flex-direction: column;
	  align-items: center;
	  justify-content: center;
	  width: 220rpx;
	  height: 350rpx;
	  margin-right: 22rpx;
	}
	.movie-item-img {
		border-radius: 5rpx;
	}
	.movie-item-title {
	  color: #606266;
	  font-size: 8rpx;
	  margin-top: 10rpx;
	}
	.movie-rate {
		height: 40rpx;
		line-height: 40rpx;
		display: flex;
		flex-direction: row;
		justify-content: space-between;
		align-items: center;
		margin-bottom: 15rpx;
	}
	
	.movie-rate-t {
		margin-right: 4rpx;
		font-size: 8rpx;
	}

最后,附上测试的工程代码源码。

资源下载地址:https://download.csdn.net/download/qq8864/89377440

其他资源

豆瓣 Api V2(测试版) | doubanapi

豆瓣网接口-CSDN博客

豆瓣电影API接口_电影数据api接口购买-CSDN博客

https://github.com/liulongbin1314/request-miniprogram

小程序项目(uniapp)_uniapp小程序项目-CSDN博客

使用微信小程序开发制作一个简单的电影资讯应用-CSDN博客

uni-app 使用escook/request-miniprogram插件发请求说明_request-miniprogram post-CSDN博客

小程序调用豆瓣公开接口解决办法(转) – 简书

https://feizhaojun.com/?p=3813

https://www.cnblogs.com/winchance/p/13230063.html

本站无任何商业行为
个人在线分享 » uniapp小程序开发 | 从零实现一款影视类app (横向滚动和下拉刷新的实现)
E-->