手把手教你用ViewPager自定义实现Banner轮播

2024-02-28 08:32

本文主要是介绍手把手教你用ViewPager自定义实现Banner轮播,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

效果演示

需求分析、解决方案
  轮播器最重要的几个特点就是:自动滚动、手动滑动、滚动方向、每个Item显示时间。因此我们设计提供以下几个方法供外部调用:

/*** 设置每个Item的播放时间,默认3000毫秒*/
public void setShowTime(int showTimeMillis);/*** 设置滚动方向,默认向左滚动*/
public void setDirection(Direction direction);/*** 开始自动滚动*/
public void start();/*** 停止自动滚动*/
public void stop();/*** 播放上一个*/
public void previous();/*** 播放下一个*/
public void next();


  仔细看过上面方法的同学会发现,和我们的分析想比,还缺少一个手动滑动的方法,我们知道手势滑动肯定要用到onTouch等方法,所以我们想到v4包下ViewPager自带滑动效果,而且可以代码控制跳转到某个Item。因此我们自定义View继承ViewPager不就完美解决了。 
  我们看到上面的方法中有一个Direction类,这个类不是系统的,是达哥自定义的方向控制枚举,目前最常见的轮播方向无非就是左右轮播(上下本次先不讨论),代码如下:

public enum Direction {/*** 向左行动,播放的下一张应该是右边的*/LEFT,/*** 向右行动,播放的下一张应该是左边的*/RIGHT
}



自定义View如何实现以及原理
  上面分析到需要继承ViewPager,so我们先结合上面的几个方法把完整的代码撸起来:

public class AutoPlayViewPager extends ViewPager {public AutoPlayViewPager(Context context) {super(context);}public AutoPlayViewPager(Context context, AttributeSet attrs) {super(context, attrs);}/*** 播放时间*/private int showTime = 3 * 1000;/*** 滚动方向*/private Direction direction = Direction.LEFT;/*** 设置播放时间,默认3秒** @param showTimeMillis 毫秒*/public void setShowTime(int showTimeMillis) {this.showTime = showTimeMillis;}/*** 设置滚动方向,默认向左滚动** @param direction 方向*/public void setDirection(Direction direction) {this.direction = direction;}/*** 开始*/public void start() {// TODO 待实现开始播放}/*** 停止*/public void stop() {// TODO 待实现停止播放}/*** 播放上一个*/public void previous() {// TODO 待实现播放上一个}/*** 播放下一个*/public void next() {// TODO 待实现播放下一个}public enum Direction {/*** 向左行动,播放的应该是右边的*/LEFT,/*** 向右行动,播放的应该是左边的*/RIGHT}
}



  setShowTime(int showTimeMillis)方法和setDirection(Direction direction)就是记录一下某一个状态而已,现在已经简单的实现了,重点就是开始播放和停止播放。 
  

定时轮播的原理分析和实现
  前方高能,各位看官小心裤子别掉了。现在我们使用ViewPager最主要的就是自动播放了,所以我们需要一个定时器去执行任务,but这样子就得用到Handler,就有点小题大做了。这里介绍View的两个方法:

// 线程将被添加到消息队列,这个线程将会在UI线程(主线程)运行。
public boolean post(Runnable action);

// 线程将被添加到消息队列,在指定的时间之后运行,这个线程将会在UI线程(主线程)运行。
public boolean postDelayed(Runnable action, long delayMillis);

  看到第二个方法犹如醍醐灌顶啊有木有,既然是所有View都有的方法,ViewPager必须有啊,这样不就可以在主线程定时发布一个任务了吗?所以我们这里写一个Runnable来做这个定时任务。

/**
 * 播放器
 */
private Runnable player = new Runnable() {
    @Override
    public void run() {
        play(direction);
    }
};

  这里看到有一个play(direction);的方法待我们去实现,我们暂且把这个方法先放一放,我们先来看怎么利用这个private Runnable player完成开始播放和停止播放。 
  

实现开始播放和停止播放
  开始播放时我们为了让当前显示的图片显示showTime的时间,所以我们利用postDelayed(Runnable action, long delayMillis);方法在showTime时间之后触发private Runnable player:

/**
 * 开始
 */
public void start() {
    postDelayed(player, showTime);
}

  停止播放,我们把这个线程给取消了就行了,因此停止的方法的实现是:

/**
 * 停止
 */
public void stop() {
    removeCallbacks(player);
}

  但是为了防止开发者不停的调用start方法造成卡死现象,我们在start中做个优化,每次star前先把之前private Runable player移除了,因此start方法完整的代码是:

/**
 * 开始
 */
public void start() {
    stop();
    postDelayed(player, showTime);
}

核心重点:如何根据方向播放上一张和下一张
  本例的核心和重点来了,现在回过头去实现刚才搁置的play(direction);方法,它要根据播放的方向来播放上一张和下一张,我们具体看代码,尤其要细细品味注释哦:

/**
 * 执行播放
 *
 * @param direction 播放方向
 */
private synchronized void play(Direction direction) {
    // 拿到ViewPager的适配器
    PagerAdapter pagerAdapter = getAdapter();
    if (pagerAdapter != null) {// 判空
        // Item数量
        int count = pagerAdapter.getCount();
        // ViewPager现在显示的第几个?
        int currentItem = getCurrentItem();
        switch (direction) {
            case LEFT:// 如是向左滚动的,currentItem+1播放下一个
                currentItem++;

                // 如果+到最后一个了,就到第一个
                if (currentItem >= count)
                    currentItem = 0;
                break;
            case RIGHT:// 如是向右滚动的,currentItem-1播放上一个
                currentItem--;

                // 如果-到低一个了,就到最后一个
                if (currentItem < 0)
                    currentItem = count - 1;
                break;
        }
        setCurrentItem(currentItem);// 播放根据方向计算出来的position的item
    }

    // 这就是当可以循环播放的重点,每次播放完成后,再次开启一个定时任务
    start();
}

  到这里其实我们已经实现轮播啦,但是我们在使用的时候发现存在一种情况,当我们用手指刚滑完一张,紧接着第二张又出来了,不卖关子了,原因就是我们手指滑动的时候private Runnable player这个任务没有停止,所以我们在手指滑动时停止player,手指松开的时候再次开启player:

@Override
protected void onFinishInflate() {
    addOnPageChangeListener(new OnPageChangeListener() {
        @Override
        public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
        }

        @Override
        public void onPageSelected(int position) {
        }

        @Override
        public void onPageScrollStateChanged(int state) {
            if (state == SCROLL_STATE_IDLE)
                start();
            else if (state == SCROLL_STATE_DRAGGING)
                stop();
        }
    });
}

  有些同学可能不知道为什么不在构造方法中而要在onFinishInflate中addOnPageChangeListener,是因为这个方法会在view被加载完成后调用,所以我们在这里做一些初始化的工作比较合理。 
  自定义ViewPager的完整代码如下:

package com.yolanda.autoviewpager;import android.content.Context;
import android.support.v4.view.PagerAdapter;
import android.support.v4.view.ViewPager;
import android.util.AttributeSet;/*** <p>用ViewPager自定义的广告轮播器。</p>.* * @author Yolanda; */
public class AutoPlayViewPager extends ViewPager {public AutoPlayViewPager(Context context) {super(context);}public AutoPlayViewPager(Context context, AttributeSet attrs) {super(context, attrs);}/*** 播放时间*/private int showTime = 3 * 1000;/*** 滚动方向*/private Direction direction = Direction.LEFT;/*** 设置播放时间,默认3秒** @param showTimeMillis 毫秒*/public void setShowTime(int showTimeMillis) {this.showTime = showTimeMillis; // 本文后期更新,demo中此处有误。}/*** 设置滚动方向,默认向左滚动** @param direction 方向*/public void setDirection(Direction direction) {this.direction = direction;}/*** 开始*/public void start() {stop();postDelayed(player, showTime);}/*** 停止*/public void stop() {removeCallbacks(player);}/*** 播放上一个*/public void previous() {if (direction == Direction.RIGHT) {play(Direction.LEFT);} else if (direction == Direction.LEFT) {play(Direction.RIGHT);}}/*** 播放下一个*/public void next() {play(direction);}/*** 执行播放** @param direction 播放方向*/private synchronized void play(Direction direction) {PagerAdapter pagerAdapter = getAdapter();if (pagerAdapter != null) {int count = pagerAdapter.getCount();int currentItem = getCurrentItem();switch (direction) {case LEFT:currentItem++;if (currentItem > count)currentItem = 0;break;case RIGHT:currentItem--;if (currentItem < 0)currentItem = count;break;}setCurrentItem(currentItem);}start();}/*** 播放器*/private Runnable player = new Runnable() {@Overridepublic void run() {play(direction);}};public enum Direction {/*** 向左行动,播放的应该是右边的*/LEFT,/*** 向右行动,播放的应该是左边的*/RIGHT}@Overrideprotected void onFinishInflate() {super.onFinishInflate();addOnPageChangeListener(new OnPageChangeListener() {@Overridepublic void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {}@Overridepublic void onPageSelected(int position) {}@Overridepublic void onPageScrollStateChanged(int state) {if (state == SCROLL_STATE_IDLE)start();else if (state == SCROLL_STATE_DRAGGING)stop();}});}
}



考虑到这里post了一个Runnable,它持有当前Activity的实例,所以在AutoPlayViewPager所在的当前Activity销毁时可能会发生内存泄漏,我们在View销毁的时候移除Runnable:

@Override
protected void onDetachedFromWindow() {
    removeCallbacks(player);
    super.onDetachedFromWindow();
}

特别注意这是后来更新文章后添加的,所以下载的demo中没有移除这个Runnable,大家千万记得自己加上。

如何使用
  其实我们没有对ViewPager做什么太大的干涉,所以我们使用和原生的没有什么区别。这里有几个注意的地方也写出来,免得有人踩坑。

如果使用自定ViewPager
AutoPlayViewPager autoPlayViewPage = (AutoPlayViewPager) findViewById(R.id.view_pager);
autoPlayViewPage.setAdapter(bannerAdapter);

// 以下两个方法不是必须的,因为有默认值
autoPlayViewPage.setDirection(AutoPlayViewPager.Direction.LEFT);// 设置播放方向
autoPlayViewPage.setCurrentItem(200); // 设置每个Item展示的时间

autoPlayViewPage.start(); // 开始轮播

如何优化Adapter
  其实我们看到就是多调用了一个star方法,但是还不够,我们在适配器中还要做一点点小事情。为了能让轮播无限循环,所以我们在getCount中返回int的最大值:

@Override
public int getCount() {
    return resIds == null ? 0 : Integer.MAX_VALUE;
}

  resIds是我们的数据源。该了这个Count后,我们的instantiateItem()方法也要修改,不然会发生下标越界的异常,我们在拿到position后要做个处理:

@Override
public Object instantiateItem(ViewGroup container, int position) {
    position = position % resIds.size();
    Object xxoo = resIds.get(position);
    ...
}

这篇关于手把手教你用ViewPager自定义实现Banner轮播的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/754953

相关文章

Flutter实现文字镂空效果的详细步骤

《Flutter实现文字镂空效果的详细步骤》:本文主要介绍如何使用Flutter实现文字镂空效果,包括创建基础应用结构、实现自定义绘制器、构建UI界面以及实现颜色选择按钮等步骤,并详细解析了混合模... 目录引言实现原理开始实现步骤1:创建基础应用结构步骤2:创建主屏幕步骤3:实现自定义绘制器步骤4:构建U

SpringBoot中四种AOP实战应用场景及代码实现

《SpringBoot中四种AOP实战应用场景及代码实现》面向切面编程(AOP)是Spring框架的核心功能之一,它通过预编译和运行期动态代理实现程序功能的统一维护,在SpringBoot应用中,AO... 目录引言场景一:日志记录与性能监控业务需求实现方案使用示例扩展:MDC实现请求跟踪场景二:权限控制与

Android实现定时任务的几种方式汇总(附源码)

《Android实现定时任务的几种方式汇总(附源码)》在Android应用中,定时任务(ScheduledTask)的需求几乎无处不在:从定时刷新数据、定时备份、定时推送通知,到夜间静默下载、循环执行... 目录一、项目介绍1. 背景与意义二、相关基础知识与系统约束三、方案一:Handler.postDel

使用Python实现IP地址和端口状态检测与监控

《使用Python实现IP地址和端口状态检测与监控》在网络运维和服务器管理中,IP地址和端口的可用性监控是保障业务连续性的基础需求,本文将带你用Python从零打造一个高可用IP监控系统,感兴趣的小伙... 目录概述:为什么需要IP监控系统使用步骤说明1. 环境准备2. 系统部署3. 核心功能配置系统效果展

Python实现微信自动锁定工具

《Python实现微信自动锁定工具》在数字化办公时代,微信已成为职场沟通的重要工具,但临时离开时忘记锁屏可能导致敏感信息泄露,下面我们就来看看如何使用Python打造一个微信自动锁定工具吧... 目录引言:当微信隐私遇到自动化守护效果展示核心功能全景图技术亮点深度解析1. 无操作检测引擎2. 微信路径智能获

Python中pywin32 常用窗口操作的实现

《Python中pywin32常用窗口操作的实现》本文主要介绍了Python中pywin32常用窗口操作的实现,pywin32主要的作用是供Python开发者快速调用WindowsAPI的一个... 目录获取窗口句柄获取最前端窗口句柄获取指定坐标处的窗口根据窗口的完整标题匹配获取句柄根据窗口的类别匹配获取句

在 Spring Boot 中实现异常处理最佳实践

《在SpringBoot中实现异常处理最佳实践》本文介绍如何在SpringBoot中实现异常处理,涵盖核心概念、实现方法、与先前查询的集成、性能分析、常见问题和最佳实践,感兴趣的朋友一起看看吧... 目录一、Spring Boot 异常处理的背景与核心概念1.1 为什么需要异常处理?1.2 Spring B

Python位移操作和位运算的实现示例

《Python位移操作和位运算的实现示例》本文主要介绍了Python位移操作和位运算的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一... 目录1. 位移操作1.1 左移操作 (<<)1.2 右移操作 (>>)注意事项:2. 位运算2.1

如何在 Spring Boot 中实现 FreeMarker 模板

《如何在SpringBoot中实现FreeMarker模板》FreeMarker是一种功能强大、轻量级的模板引擎,用于在Java应用中生成动态文本输出(如HTML、XML、邮件内容等),本文... 目录什么是 FreeMarker 模板?在 Spring Boot 中实现 FreeMarker 模板1. 环

Qt实现网络数据解析的方法总结

《Qt实现网络数据解析的方法总结》在Qt中解析网络数据通常涉及接收原始字节流,并将其转换为有意义的应用层数据,这篇文章为大家介绍了详细步骤和示例,感兴趣的小伙伴可以了解下... 目录1. 网络数据接收2. 缓冲区管理(处理粘包/拆包)3. 常见数据格式解析3.1 jsON解析3.2 XML解析3.3 自定义