ViewPager封装轮播效果+指示器 实现一行代码展示轮播图

 


无量变何以质变

 
 


概述

平时应用开发中首页经常会有一个Banner轮播的展示,不可避免的需要封装一个自定义View,在使用的时候能够方便的只用一句代码设置图片地址集合,就可以启动轮播效果,本文将通过ViewPager一步步对轮播图进行实现,最终效果如下:

轮播.gif

 

需要定制的特性

1.是否显示指示器

2.指示器圆点大小、间距

3.轮播自动切换的间隔时长

4.是否自动轮播

5.左右无边界轮播

:目前暂时只支持url的图片形式,其他形式例如本地图片可自行在Adapter中instantiateItem方法进行调整,且本文的图片展示是依赖Glide来展示。
 

实现思路

我们都知道ViewPager是可以左右滑动的,并且可以设置Adapter, 那如果能够设置为无限大,且每隔一段时间就调用滑动,即可达到轮播效果,主要需要解决以下几个问题:如何实现无限循环,自动轮播以及兼容手势滑动。


1)实现无限循环

首先实现左右无限循环的效果,思路就是将ViewPager的getCount()返回为Integer.MAX_VALUE,然后在ViewPager每次切换Item的时候,会调用PagerAdapter的instantiateItem方法,这个方法返回当前准备切换到的下标,由于我们设置的Item数量是Integer.MAX_VALUE,因此这里返回的下标有可能是0-2147483647。

假设我们要显示的banner图总共有3张,那在第3张即将切换到第1张的时候,需要重新将position置为0,因此可以采用对下标取余的方式让position可以一直处于0-3的无限循环之中。

关键代码如下:


private class InnerPagerAdapter extends PagerAdapter {

        public InnerPagerAdapter() {}


        @Override
        public int getCount() {
            return Integer.MAX_VALUE;
        }


        @Override
        public boolean isViewFromObject(View arg0, Object arg1) {
            return arg0 == arg1;
        }

 

        @Override
        public Object instantiateItem(ViewGroup container, int position) {

            position %= mBannerUrlList.size();

            if (position < 0) {
                position = mBannerUrlList.size() + position;
            }

            ImageView bannerIv = new ImageView(getContext());

            bannerIv.setScaleType(ImageView.ScaleType.CENTER_CROP);

            bannerIv.setLayoutParams(new LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));

            Glide.with(getContext()).load(mBannerUrlList.get(position)).into(bannerIv);

            container.addView(bannerIv);

            //bannerIv.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));

            return bannerIv;
        }


        @Override
        public void destroyItem(ViewGroup container, int position, Object object) {
        }

}

 
 


2)实现自动轮播

实现了左右无限轮播,接下来就要让它能够自动动起来,这里采用handler的方式,每次将下标+1之后setCurrentItem为新的下标,关键代码如下:


/**
 * 是否自动滑动
 */
private boolean mIsAutoScroll = true;

/**
 * 默认页面之间自动切换的时间间隔
 */
private long mDelayTime = 2000;

//播放标志
private boolean isPlay = false;

//触发轮播的消息标志位
private final int PLAY = 0x123;

/**
 * 轮播计时器
 */
private Handler mHandler = new Handler() {

    public void handleMessage(android.os.Message msg) {
        if (msg.what == PLAY && mIsAutoScroll) {
            mBannerViewPager.setCurrentItem(mCurrentIndex);

            if (isPlay) {
                play();
            }
        }
    }
};


public void startPlay(long delayMillis) {
    isPlay = true;
    mDelayTime = delayMillis;
    play();
}

private void play() {
    mCurrentIndex++;
    mHandler.sendEmptyMessageDelayed(PLAY, mDelayTime);
}

 
 


3)兼容手势滑动

实现了自动轮播之后,我们还要兼容用户主动滑动的场景,即用户主动滑动时,应该暂停自动轮询,先以用户主动滑动的动作为主,当用户放开手指之后,再重新继续自动轮询,既然要区分是否是手势滑动,可以在ViewPager的滑动监听接口onPageScrollStateChange中去判断,如下:

/**
  * ViewPager滑动监听
  */
ViewPager.OnPageChangeListener mPageListener = new ViewPager.OnPageChangeListener() {
    @Override
    public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
    }

    @Override
    public void onPageSelected(int position) {
    }

    @Override
    public void onPageScrollStateChanged(int state) {
        onPageScrollStateChange(state);
    }
};

 /**
   * 手指滑动时暂停自动轮播,手指松开时重新启动自动轮播
   *
   * @param state
   */
private void onPageScrollStateChange(int state) {
    if (!mIsAutoScroll) {
        return;
    }
    switch (state) {
        case ViewPager.SCROLL_STATE_IDLE:
            if (!mGestureScroll) {
                return;
            }
            mGestureScroll = false;
            mHandler.removeMessages(PLAY);
            mHandler.sendEmptyMessageDelayed(PLAY, 100);
            break;
        case ViewPager.SCROLL_STATE_DRAGGING:
            // 手指滑动时,清除播放下一张,防止滑动过程中自动播放下一张
            mGestureScroll = true;
            mHandler.removeMessages(PLAY);
            break;
        default:
            break;
    }
}

ViewPager的SCRPLL_STATE_IDLE状态是表示用户手指松开时,这个时候就继续sendMessage启动轮询,SCROLL_STATE_DRAGGING状态表示用户手指正在滑动过程中,removeMessage将当前的轮询暂停

 
 


4)添加轮播指示器

以上完成了ViewPager的部分,实现了轮播图的自动轮询效果,但一般轮播图都会有个小小的指示器来让用户感知当前处于哪个banner,一共有多少个banner,所以我们还需套自定义一个指示器View

/**
  * 指示器View
 */
public class BannerIndicator extends View{

    private int mCellCount;
    private int currentPosition;
    private Paint mPaint;
    /**
     * 指示器小圆点半径
     */
    private int mCellRadius = dp2px(3);
    /**
     * 指示器小圆点间距
     */
    private int mCellMargin = dp2px(4);
    /**
     * 指示器小圆点激活状态的颜色
     */
    private int mIndicatorColor = Color.parseColor("#000000");

    public BannerIndicator(Context context) {
        super(context);
        init();
    }

    public void init(){
        mPaint = new Paint();
        mPaint.setAntiAlias(true);
    }

    public void setCellCount(int cellCount) {
        mCellCount = cellCount;
        invalidate();
    }

    public void setCurrentPosition(int currentPosition) {
        this.currentPosition = currentPosition;
        invalidate();
    }

    @Override
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
        super.onMeasure(widthMeasureSpec, heightMeasureSpec);
        // 重新测量当前界面的宽度
        int width = getPaddingLeft() + getPaddingRight() + mCellRadius * 2 * mCellCount + mCellMargin * (mCellCount - 1);
        int height = getPaddingTop() + getPaddingBottom() + mCellRadius * 2;
        width = resolveSize(width, widthMeasureSpec);
        height = resolveSize(height, heightMeasureSpec);
        setMeasuredDimension(width, height);
    }

    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        for (int i = 0; i < mCellCount; i++) {
            if (i == currentPosition) {
                mPaint.setColor(mIndicatorColor);
            } else {
                mPaint.setColor(Color.WHITE);
            }
            int left = getPaddingLeft() + i * mCellRadius * 2 + mCellMargin * i;

            canvas.drawCircle(left + mCellRadius, getHeight() / 2, mCellRadius, mPaint);
        }
    }
}

其实就是根据banner的数量来进行绘制每个小圆圈的位置,并且用一个currentPosition来标志当前哪个小圆圈是处于激活的状态,显示不同的颜色。在ViewPager每次回调onPageSelect的时候,将当前的currentPosition也同步更新,并且调用invalidate触发onDraw重新绘制。
 
 


5)开放滑动监听接口

最后,虽然内部实现了自动轮播,但是我们还是要将滑动切换的接口放开来

/**
 * 滚动监听回调接口
 */

ScrollPageListener mScrollPageListener;

public void setScrollPageListener(ScrollPageListener mScrollPageListener) {
        this.mScrollPageListener = mScrollPageListener;
}

public interface ScrollPageListener {
    void onPageSelected(int position);
}
 

ViewPager.OnPageChangeListener mPageListener = new ViewPager.OnPageChangeListener() {

    @Override
    public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {}

    @Override
    public void onPageSelected(int position) {
        if (mScrollPageListener != null) {
            mScrollPageListener.onPageSelected(smallPos);
        }
    }

    @Override
    public void onPageScrollStateChanged(int state) {
        onPageScrollStateChange(state);
    }
};

 
 


6)提供设置Banner数据接口

提供一个供外界设置banner数据的方法:


/**
 * 设置Banner图片地址数据
 * @param bannerData
 */
public void setBannerData(List<String> bannerData) {
    mBannerUrlList.clear();
    mBannerUrlList.addAll(bannerData);
    mAdapter.notifyDataSetChanged();
    startPlay(mDelayTime);
    mIndicator.setCellCount(bannerData.size());
}

 
 


应用

xml布局中引用(如果是wrap_content,默认是200dp的高度,可在自定义View的onMeasure中自行调整):

<com.example.zjy.zjywidget.banner.BannerView
        android:id="@+id/banner_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">
</com.example.zjy.zjywidget.banner.BannerView>

从此之后实现Banner轮播效果就方便多了,只需要一句代码即可:

mBannerView.setBannerData(getBannerData());

getBannerData就是你的图片url集合,将其设置进去,开启你的自动轮播吧~~~

 
 


后续

ViewPager不止可以做轮播,还支持自定义各种切换动画,详见我另一篇文章 Android ViewPager多屏显示、切换动画,让你的轮播炫起来

最近有点沉迷于自定义View,其实很多看似很基础的东西还是很重要的,底层基础决定上层建筑,本篇的轮播效果尽管并不复杂,但是巧妙利用View的属性有时候能够带来不错的效果。这里还存在一个无限大所导致的内存隐患问题,不知道广大简友有没有更好的方案进行优化?

源码传送门GitHub-ZJYWidget-YCircleProgressBar
CSDN博客IT_ZJYANG
简          书Android小Y

里面还有很多实用的自定义View源码及demo,会长期维护,欢迎Star~ 如有不足之处或建议还望指正,相互学习,相互进步,如果觉得不错动动小手点个喜欢, 谢谢~

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,560评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,104评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,297评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,869评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,275评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,563评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,833评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,543评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,245评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,512评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,011评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,359评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,006评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,062评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,825评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,590评论 2 273
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,501评论 2 268

推荐阅读更多精彩内容