Flutter 封装一个 Banner 轮播图效果的实例代码

实际业务开发中,首页一般都会存在一个轮播图。

在 Flutter 中,如何开发一个轮播?

Flutter 封装一个 Banner 轮播图效果的实例代码


了解需求

首先,我们在开发一个功能的时候要了解这个功能的需求,那一个轮播需要有什么功能?

1. 可以自定义高度和一些属性 2. 展示图片 3. 自动翻页播放 4. 点击事件 5. 指示器 6. 人为拖动的时候关闭自动播放

其中「人为拖动的时候关闭自动播放」是比较难的,我们后续会说,那先一个一个功能来实现。

自定义高度和一些属性

这里主要是做一些前期的工作,如果我们的 Banner 要开源让别人来使用,那我们肯定是要给用户一些可以自定义的属性的,比如:

1. Banner 的高度 2. 图片切换的效果 3. 点击事件的回调

既然我们是封装一个 Widget,那我们新建一个文件 widget_banner.dart ,类名叫  CustomBanner , 构造函数如下:

CustomBanner(

 this._images,{

 this.height = 200,this.onTap,this.curve = Curves.linear,}) : assert(_images != null);

• _images:首先,图片的链接必须有,并且在后面也做了一个断言验证

• height:其次,高度可以让用户自己定义,默认为200

• onTap:用户点击的回调,是一个  ValueChanged<int> ,回调一个 index

• curve:图片在切换时候的效果,默认为  Curves.linear

这样初期的准备工作已经做完,下面就开始做展示图片的功能。

展示图片

一般的 Banner 都是由一些图片组成,然后在固定的时间内翻页,

那能够翻页的 Widget,我们首先想到的是 PageView ,而  PageView 也正好能满足我们的需求,

它有如下几个属性:

1. 多页面翻页

2. 有控制器控制翻页

3. 翻页的回调

4. 无限页面

那我们首先就来定义一个 PageView :

Widget _buildPageView() {
 var length = widget._images.length;
 return Container(
 height: widget.height,child: PageView.builder(
 controller: _pageController,onPageChanged: (index) {
 if (index == 0) {
 _curIndex = length;
 }
 },itemBuilder: (context,index) {
 return Image.network(
 widget._images[index % length],fit: BoxFit.cover,);
 },),);
}

这里定义了一个方法通过 PageView.builder 来生成  PageView ,用该方法的好处是可以生成无限个 Page,这样就不用担心滑到右侧边界的问题。

那有人会问如果是左侧的边界该怎么办?

看 onPageChange 方法,我们判断了如果  index == 0 那就把  _curIndex 改为 length,为什么改为 length?

因为在 itemBuilder 中,返回的是  widget._images[index % length] ,用 index 对 length 取余,这样就保证了我们的图片不会数组越界,并且第 length 个图片就是第一个图片,这样就保证左侧的边界也不会被触碰到了。

在 PageView 的上方也是定义了一个 Container 来限定高度,来看一下效果:

Flutter 封装一个 Banner 轮播图效果的实例代码


自动翻页播放

现在能展示图片了,那就该来做自动翻页了。

一般在 Dart 中,使用 Timer.periodic() 来做循环定时任务,该方法有两个参数:

1. duration:指隔多长时间执行一次 2. callback:时间到的时候执行的任务

那有了该方法,我们就可以很轻松的写出自动播放:

_timer = Timer.periodic(Duration(seconds: 3),(t) {
 _curIndex++;
 _pageController.animateToPage(
 _curIndex,duration: Duration(milliseconds: 300),curve: Curves.linear,);
});

在上面我们给 PageView 定义了一个  controller ,这里就可以用上了,

首先定义 Timer.periodic 方法,指出每三秒执行一次,然后在回调任务中执行:

1. _curIndex++:index +1 2. 使用 controller 的  animateToPage  方法,该方法是有动画效果的跳转

animateToPage 有三个参数:

1. 跳转的页面 2. 跳转到该页面动画持续时间(也就是多长时间能翻到该页) 3. 动画的效果

定义好后,我们来看一下效果:

Flutter 封装一个 Banner 轮播图效果的实例代码


点击事件

现在自动播放也 ok 了,那基本的就剩一个点击事件了。

点击事件非常简单,我们可以在 PageView 上面加一个  GestureDetector 来识别手势,

但是我又不想在 PageView 上面加,为什么?

因为后续要添加指示器,指示器应该也要有自己的点击事件,比如点击第二个小圆点就跳转到第二页之类的,

所以,我们要在 Image 上面添加手势识别:

return GestureDetector(
 onTap: () {
 Scaffold.of(context).showSnackBar(
 SnackBar(
 content: Text('当前 page 为 ${index % length}'),duration: Duration(milliseconds: 500),child: Image.network(
 widget._images[index % length],);

非常简单,就是增加了一个 GestureDetector ,来看一下效果:

Flutter 封装一个 Banner 轮播图效果的实例代码


讲道理,现在一个最最基本的 Banner 就已经完成了,能看图片,有轮播,有点击事件。

但是还并不完善,下面来做指示器。

指示器

一般的轮播,都会有一个指示器,例如下面的小圆点,或者「1 / 3」类似于这种,那我们这里就只搞第一种小圆点。

作为指示器,应该有如下几点:

1. 在图片前面(废话,在图片后面也看不到) 2. 有几张图片就有几个指示器 3. 显示出当前在第几页

在图片前面显示

这个需求比较简单,我们用一个 Stack 来包裹住  PageView 和  Indicator 就ok了:

return Stack(
 alignment: Alignment.bottomCenter,children: <Widget>[
 _buildViewPager(),_buildIndicator(),],);

定义了一个 _buildIndicator() 方法,该方法用来构建一个指示器。

有几张图片就有几个指示器

我们这里说的指示器就是小圆点,也很简单,用 ClipOval 来创建一个圆形就ok了,

具体代码如下:

Widget _buildIndicator() {
 var length = widget._images.length;
 return Positioned(
 bottom: 10,child: Row(
 children: widget._images.map((s) {
 return Padding(
 padding: const EdgeInsets.symmetric(horizontal: 3.0),child: ClipOval(
 child: Container(
 width: 8,height: 8,color: Colors.grey,);
 }).toList(),);
}

逻辑为:

1. 首先获取到图片数据的长度 2. Stack 定义了 Aligment 为  bottomCenter 3. 然后定义了一个  Positioned  来控制距离底部的距离 4. child 为  Row ,横向排列小圆点 5. 给每个小圆点设置边距为3 6. 小圆点的大小为8

看一下效果:

Flutter 封装一个 Banner 轮播图效果的实例代码


可以发现小圆点确实是出来了,但是并没有指示到当前是哪一个。

显示出当前在第几页

那接下来就要显示出当前是在第几页,其实这个也很简单(如果不做特殊效果的话),

我们刚才指示器的小圆点是灰色的,那当前页的小圆点我们给弄成白色的:

Widget _buildIndicator() {
 var length = widget._images.length;
 return Positioned(
 bottom: 10,color: s == widget._images[_curIndex % length]
 ? Colors.white
 : Colors.grey,);
}

这里的重点是 Container 的 color 属性,判断一下当前的值是否是和当前 index 的值相等,

如果相等则变为白色,如果不相等则是灰色。

如果光写成这样,小圆点是不会变的,所以我们要在 PageView 的  onPageChanged 回调中去  setState() ,

顺便更新 _curIndex 的值。

重新构建一下刷新页面,这个时候看一下效果:

Flutter 封装一个 Banner 轮播图效果的实例代码


这个时候这个 Banner 可以说是很完善了,但是如果我们手动的去干预滑动会出现什么问题呢?

因为我们刚才写的是 3 秒一切换,所以我们在,手动切换的时候,它在到达第三秒后,就会出现连续换页的情况。

人为拖动的时候关闭自动播放

所以,根据上述情况,我们就要在监听到有人为拖动的时候去关闭自动播放,然后在没有人为的情况下打开。

刚才已经在 Image 上面加了一个  GesutreDetector ,正好,我们添加  onPanDown 参数来暂停定时任务。

然后在手指离开的时候恢复任务。

但是!这里有很大的坑!

1. Timer 没有暂停方法 2. 因为用的是  PageView ,有滑动冲突, 所以监听不到手指离开的方法

这里只能采用曲线救国的方法:

1.

虽然 Timer 没有暂停,但是他有取消  cancel() 方法。

2.

虽然监听不到手指离开的方法,但是我们可以监听到手指触碰的方法

所以我们应该这么写:

/// 点击到图片的时候取消定时任务
_cancelTimer() {
 if (_timer != null) {
 _timer.cancel();
 _timer = null;
 _initTimer();
 }
}
/// ------------------------
return GestureDetector(
 onPanDown: (details) {
 _cancelTimer();
 },onTap: () {
 Scaffold.of(context).showSnackBar(
 SnackBar(
 content: Text('当前 page 为 ${index % length}'),);

先定义一个方法, _cancelTimer() ,里面首先判断如果  _timer 不是 null 的时候则把 _timer 取消掉,然后置空。

随后再对 _timer 进行初始化。

为什么要这么做?取消的同时进行初始化?

因为我们并不知道什么时候手指离开屏幕,所以我们在手指点击后就 重新开始计时 ,

这样既能保证点击的时候没有定时任务,又能保证在后续的一段时间后会重新开始定时任务。

因为定时任务的时间是3秒,而我们滑动查看图片也就一两秒的时间,这段时间之内如果再次手动滑动,那么也会取消掉之前的任务,重新开始新的任务,这样就达到了我们的效果。

来看一下:

Flutter 封装一个 Banner 轮播图效果的实例代码


那到现在为止整个 Banner 的封装就结束了。

总结

首先,在封装一个 Widget 的时候,首先要了解该 Widget 的功能,根据功能的需求来实现,

而且在实现的过程中,要考虑到灵活的问题,可以给用户来设置的就要暴露出来,而不能暴露的方法就要写成私有的。

完整代码已经传至GitHub:https://github.com/wanglu1209/WFlutterDemo

以上所述是小编给大家介绍的Flutter 封装一个 Banner 轮播图的实例代码详解,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对我们网站的支持!
如果你觉得本文对你有帮助,欢迎转载,烦请注明出处,谢谢!

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


AdvserView.java package com.earen.viewflipper; import android.content.Context; import android.graphics.Bitmap; import android.graphics.BitmapFactory;
ImageView的scaleType的属性有好几种,分别是matrix(默认)、center、centerCrop、centerInside、fitCenter、fitEnd、fitStart、fitXY。 |值|说明| |:--:|:--| |center|保持原图的大小,显示在ImageVie
文章浏览阅读8.8k次,点赞9次,收藏20次。本文操作环境:win10/Android studio 3.21.环境配置 在SDK Tools里选择 CMAKE/LLDB/NDK点击OK 安装这些插件. 2.创建CMakeLists.txt文件 在Project 目录下,右键app,点击新建File文件,命名为CMakeLists.txt点击OK,创建完毕! 3.配置文件 在CMa..._link c++ project with gradle
文章浏览阅读1.2w次,点赞15次,收藏69次。实现目的:由mainActivity界面跳转到otherActivity界面1.写好两个layout文件,activity_main.xml和otherxml.xmlactivity_main.xml&lt;?xml version="1.0" encoding="utf-8"?&gt;&lt;RelativeLayout ="http://schemas..._android studio 界面跳转
文章浏览阅读3.8w次。前言:最近在找Android上的全局代理软件来用,然后发现了这两款神作,都是外国的软件,而且都是开源的软件,因此把源码下载了下来,给有需要研究代理这方面的童鞋看看。不得不说,国外的开源精神十分浓,大家相互使用当前基础的开源软件,然后组合成一个更大更强的大开源软件。好吧,废话不多说,下面简单介绍一下这两款开源项目。一、ProxyDroid:ProxyDroid功能比较强大,用到的技术也比较多,源码也_proxydroid
文章浏览阅读2.5w次,点赞17次,收藏6次。创建项目后,运行项目时Gradle Build 窗口却显示错误:程序包R不存在通常情况下是不会出现这个错误的。我是怎么遇到这个错误的呢?第一次创建项目,company Domain我使用的是:aven.com,但是创建过程在卡在了Building 'Calculator' Gradle Project info这个过程中,于是我选择了“Cancel”第二次创建项目,我还是使用相同的项目名称和项目路_r不存在
文章浏览阅读8.9w次,点赞4次,收藏43次。前言:在Android上使用系统自带的代理,限制灰常大,仅支持系统自带的浏览器。这样像QQ、飞信、微博等这些单独的App都不能使用系统的代理。如何让所有软件都能正常代理呢?ProxyDroid这个软件能帮你解决!使用方法及步骤如下:一、推荐从Google Play下载ProxyDroid,目前最新版本是v2.6.6。二、对ProxyDroid进行配置(基本配置:) (1) Auto S_proxydroid使用教程
文章浏览阅读1.1w次,点赞4次,收藏17次。Android Studio提供了一个很实用的工具Android设备监视器(Android device monitor),该监视器中最常用的一个工具就是DDMS(Dalvik Debug Monitor Service),是 Android 开发环境中的Dalvik虚拟机调试监控服务。可以进行的操作有:为测试设备截屏,查看特定进程中正在运行的线程以及堆栈信息、Logcat、广播状态信息、模拟电话_安卓摄像头调试工具
文章浏览阅读2.1k次。初学Android游戏开发的朋友,往往会显得有些无所适从,他们常常不知道该从何处入手,每当遇到自己无法解决的难题时,又往往会一边羡慕于 iPhone下有诸如Cocos2d-iphone之类的免费游戏引擎可供使用,一边自暴自弃的抱怨Android平台游戏开发难度太高,又连个像样的游 戏引擎也没有,甚至误以为使用Java语言开发游戏是一件费力不讨好且没有出路的事情。事实上,这种想法完全是没有必_有素材的游戏引擎
文章浏览阅读3.2k次,点赞2次,收藏2次。2014年12月从csdn专家福利获得的一本书《Android游戏开发技术实战详解》,尘封了一年多的时间,今天才翻开来看。我认识中的Android,提到Android最先浮现在我脑海中的是那可爱的机器人图标:这个Logo是由Ascender公司设计的,诞生于2010年,其设计灵感源于男女厕所门上的图形符号(真的是灵感无处不在),于是布洛克绘制了一个简单的机器人,它的躯干就像锡罐的形状,头上还有两根_智能手机的特点有哪些?
文章浏览阅读8.1k次,点赞9次,收藏11次。首先,Android是不是真的找工作越来越难呢?这个可能是大家最关心的。这个受大的经济环境以及行业发展前景的影响,同时也和个人因素有关。2016-08-26近期一方面是所在的公司招聘Java开发人员很难招到合适的,投简历的人很少;而另一方面,经常听身边的人说Android、iOS方面找工作不好找,特别是没什么经验的,经验比较少的!说是不好找,但在我家所在的吉林省省会长春,会Unity3D+Maya_android 开发和asp.net哪个好 site:blog.csdn.net
文章浏览阅读6.1k次。在上篇“走进Android开发的世界,HelloWorld”,我们创建了一个Android 项目 HelloWorld,并演示了如何通过USB连接手机查看运行效果;而如果没有手机或没有对应型号的手机,又想做对应型号(屏幕尺寸、Android系统版本)的适配,应该怎么办呢?这时Android模拟器就派上用场了。Android模拟器Android SDK自带一个移动模拟器。它是一个可以运行在你电脑上的_安卓移动开发软件怎样预览
文章浏览阅读8.9k次。Google IO 2017 上宣布,将Kotlin语言作为安卓开发的官方语言。Kotlin由JetBrains公司开发,与Java 100%互通,并具备诸多Java尚不支持的新特性。谷歌称还将与JetBrains公司合作,为Kotlin设立一个非盈利基金会。Kotlin 是一个基于 JVM 的静态类型编程语言,Kotlin可以编译成Java字节码,也可以编译成JavaScript,方便在没有JV_kotlin为什么被嫌弃
文章浏览阅读9.6w次,点赞17次,收藏35次。有些情况下,不方便使用断点的方式来调试,而是希望在控制台打印输出日志,使用过Eclipse的同学都知道Java可以使用 System.out.println(""); 来在控制台打印输出日志,但是在android studio中却是不行的,还是有差别的,那应该用什么呢?android.util.Log在调试代码的时候我们需要查看调试信息,那我们就需要用Android Log类。android.ut_andirod.studio 为什么不在控制台打印输出
文章浏览阅读8.2k次,点赞2次,收藏8次。在上篇“走进Android开发的世界,HelloWorld”,我们创建了一个Android 项目 HelloWorld,并演示了如何通过USB连接手机查看运行效果;这里讲一下如何为应用添加一个按钮,并为按钮添加Click单击事件处理程序,显示/隐藏另一个按钮。添加按钮在HelloWorld项目的基础上,打开界面布局文件:activity_main.xml切换到Design(设计)模式;在组件But_activity_main.xml按钮隐藏
文章浏览阅读2.9k次,点赞3次,收藏9次。android 开发工具主流的还是Android Studio,当然也有很多人喜欢用Eclipse,也有人喜欢用IntelliJ IDEA ;还有Xamarin这种只需要编写一次代码,可以编译多种平台可运行的强大工具。但是它又真的强大吗?就我看来没有,身边很多人还是在用Android Studio、XCode开发应用,没见谁在用Xamarin之类的工具。系统要求WindowsMicrosoft®_android开发下载安装
文章浏览阅读4.2k次,点赞7次,收藏26次。你知道Hello World程序的由来吗?对于大多数编程语言的学习来说,真正入门的一课就是 Hello World!会而不难,难而不会。虽然很多人写过关于Android开发Hello World的文章,但随着时间的推移,开发工具、技术的进步,可能有些已经过时了。我就记录一下当下我所经历的第一个Android APP HelloWorld。一、准备1、开发环境参考:Android Studio 下载_android helloworld textview 句柄获取
这篇“android轻量级无侵入式管理数据库自动升级组件怎么实现”文章的知识点大部分人都不太理解,所以小编给大家总结了以下内容,内容详细,步骤清晰,具有一定...
今天小编给大家分享一下Android实现自定义圆形进度条的常用方法有哪些的相关知识点,内容详细,逻辑清晰,相信大部分人都还太了解这方面的知识,所以分享这篇文...
这篇文章主要讲解了“Android如何解决字符对齐问题”,文中的讲解内容简单清晰,易于学习与理解,下面请大家跟着小编的思路慢慢深入,一起来研究和学习“Android...