Android 第三方轮播图控件ConvenientBanner:通用的广告栏控件

首先我先声明一下这是一个三方控件，我在这里仅仅是介绍一下用法，当然你也许会说不就是一个轮播图吗？还用得着用第三方的，真是菜比，没错，我确实是菜比，不过有现成的好用的简单的 为何还一定要自己造轮子，自己写的难免问题多

我要介绍的轮播图控件是ConvenientBanner:通用的广告栏控件，让你轻松实现广告头效果。支持无限循环，可以设置自动翻页和时间(而且非常智能，手指触碰则暂停翻页，离开自动开始翻页。你也可以设置在界面onPause的时候不进行自动翻页，onResume之后继续自动翻页)，并且提供多种翻页特效。 对比其他广告栏控件，大多都需要对源码进行改动才能加载网络图片，或者帮你集成不是你所需要的图片缓存库。而这个库能让有代码洁癖的你欢喜，不需要对库源码进行修改你就可以使用任何你喜欢的网络图片库进行配合

如果你喜欢研究源码 如果你想学的更多 请参考原始项目地址
ConvenientBanner原始项目地址

我这里只是简单介绍下用法

我开发用的是Android Studio(以下简称AS)
1 如果你开发也用的是AS，那么很简单，在你的build.gradle文件里面加入 compile ‘com.bigkoo:convenientbanner:2.0.5’
当然如果你还在使用eclipse，那么去上面项目地址下载demo拷贝架包吧 说一句废话哈 还是早点转AS吧 AS比eclipse智能好用方便。
2 布局文件中使用

<com.bigkoo.convenientbanner.ConvenientBanner
                android:id="@+id/id_cb"
                android:layout_width="match_parent"
                android:layout_height="100dp"
                app:canLoop="true"   //控制循环与否
        />
   
   
1
2
3
4
5
6
   
   

    
    
   
   

3 代码中使用
(1) 自定义你的holder 这个非常简单 实现Holder接口 实现未实现的方法

public class ImageViewHolder implements Holder<Integer>{
                 private ImageView imageView;
                @Override
                public View createView(Context context) {
                    imageView = new ImageView(context);
                    imageView.setScaleType(ImageView.ScaleType.CENTER_CROP);
                    return imageView;
                }
                @Override
                public void UpdateUI(Context context, int position, Integer data) {

                    imageView.setImageResource(data);
                }
        }
   
   
1
2
3
4
5
6
7
8
9
10
11
12
13
14
   
   

    
    
   
   

(2)给convenientBanner设置setPages

mCb.setPages(new CBViewHolderCreator<ImageViewHolder>() {
                @Override
                public ImageViewHolder createHolder() {
                    return new ImageViewHolder();
                }
                },mImageList)
                .setPageIndicator(new int[]  {R.drawable.ponit_normal,R.drawable.point_select}) //设置两个点作为指示器
                .setPageIndicatorAlign(ConvenientBanner.PageIndicatorAlign.CENTER_HORIZONTAL); //设置指示器的方向水平  居中
   
   
1
2
3
4
5
6
7
8
   
   

    
    
   
   

(3)记得设置mCb.startTurning(2000)开启轮播图循环翻页，至此 一个轮播图框架就搭建好了。
(4) 轮播图条目点击事件，项目中点击轮播图条目一般都会有跳页操作 我们可以在这个方法中处理跳页操作

mCb.setOnItemClickListener(new OnItemClickListener() {
                @Override
                public void onItemClick(int position) {
                    Toast.makeText(MainActivity.this,"点击了条目"+position,Toast.LENGTH_LONG).show();
                }
        });
   
   
1
2
3
4
5
6
   
   

    
    
   
   

(5)如果是加载网络图片记得在清单文件中加上网络权限

4 常用方法介绍

mCb.setPageIndicator(int[])  这个是设置指示器的方法
        mCb.setPageIndicatorAlign(ConvenientBanner.PageIndicatorAlign) 设置指示器方向 
        mCb.startTurning(2000);      //设置开始轮播以及轮播时间  建议在onResume方法中设置
        mCb.stopTurning();              //停止轮播  建议在onPause方法中设置
        mCb.setManualPageable(false);//设置不能手动影响  默认是手指触摸 轮播图不能翻页
        mCb.setCanLoop(boolean);  //默认true,设置轮播图是否轮播
   
   
1
2
3
4
5
6
   
   

    
    
   
   

5 源代码下载
6 效果图