Android轮播图控件CustomBanner的使用讲解

今天给你们讲解的是Android轮播图控件CustomBanner的使用。CustomBanner是我在GitHub上传的一个Android轮播图控件。在上一篇博客 《Android轮播图控件的实现详解》中，我详细分析了CustomBanner的实现思路和核心代码，尚未看过的同窗建议先看一下，这样不管是你想本身实现一个轮播图控件，仍是使用CustomBanner都大有好处。

如今咱们开始讲解CustomBanner的具体使用，CustomBanner在GitHub的地址是：github.com/donkinglian…

一、引入依赖 在Project的build.gradle在添加如下代码

allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}
复制代码

在Module的build.gradle在添加如下代码

dependencies {
	        compile 'com.github.donkingliang:CustomBanner:1.1.0'
	}
复制代码

二、编写布局

<!-- 设置普通指示器 -->
	<com.donkingliang.banner.CustomBanner xmlns:app="http://schemas.android.com/apk/res-auto" android:id="@+id/banner" android:layout_width="match_parent" android:layout_height="180dp" app:indicatorStyle="ORDINARY" //指示器类型 普通指示器 app:indicatorGravity="CENTER_HORIZONTAL" //指示器的位置 有左。中、右三个值 app:indicatorSelectRes="@drawable/shape_point_select" //指示器的选中的样式 app:indicatorUnSelectRes="@drawable/shape_point_unselect" //指示器的未选中的样式 app:indicatorInterval="5dp"/> //指示器的点的间隔


	<!-- 设置数字指示器 -->
	<com.donkingliang.banner.CustomBanner xmlns:app="http://schemas.android.com/apk/res-auto" android:id="@+id/banner" android:layout_width="match_parent" android:layout_height="180dp" app:indicatorStyle="NUMBER" //指示器类型 数字指示器 app:indicatorGravity="RIGHT"/> //指示器的位置 有左。中、右三个值


	<!-- 设置没有指示器 -->
	<com.donkingliang.banner.CustomBanner xmlns:app="http://schemas.android.com/apk/res-auto" android:id="@+id/banner" android:layout_width="match_parent" android:layout_height="180dp" app:indicatorStyle="NONE"/> //指示器类型 没有指示器
复制代码

三、CustomBanner的方法使用 1）、设置数据

mBanner.setPages(new CustomBanner.ViewCreator<String>() {
    @Override
    public View createView(Context context, int position) {
        //这里返回的是轮播图的项的布局 支持任何的布局
        //position 轮播图的第几个项
        ImageView imageView = new ImageView(context);
        return imageView;
    }

    @Override
    public void updateUI(Context context, View view, int position, String data) {
     //在这里更新轮播图的UI
     //position 轮播图的第几个项
     //view 轮播图当前项的布局 它是createView方法的返回值
     //data 轮播图当前项对应的数据
    Glide.with(context).load(data).into((ImageView) view);
    }
}, beans);
复制代码

轮播图的布局支持任何的布局，轮播图的数据类型也是支持任何的数据类型，这里只是用ImageView和String举例而已。

2）、其余方法的使用

//设置指示器类型，有普通指示器(ORDINARY)、数字指示器(NUMBER)和没有指示器(NONE)三种类型。
//这个方法跟在布局中设置app:indicatorStyle是同样的
mBanner.setIndicatorStyle(CustomBanner.IndicatorStyle.ORDINARY);

//设置两个点图片做为翻页指示器，只有指示器为普通指示器(ORDINARY)时有用。
//这个方法跟在布局中设置app:indicatorSelectRes、app:indicatorUnSelectRes是同样的。
//第一个参数是指示器的选中的样式，第二个参数是指示器的未选中的样式。
mBanner.setIndicatorRes(R.drawable.shape_point_select,R.drawable.shape_point_unselect)；
      
//设置指示器的指示点间隔，只有指示器为普通指示器(ORDINARY)时有用。
//这个方法跟在布局中设置app:indicatorInterval是同样的。
mBanner.setIndicatorInterval(20)

//设置指示器的方向。
//这个方法跟在布局中设置app:indicatorGravity是同样的。
mBanner.setIndicatorGravity(CustomBanner.IndicatorGravity.CENTER_HORIZONTAL)

//设置轮播图自动滚动轮播，参数是轮播图滚动的间隔时间
//轮播图默认是不自动滚动的，若是不调用这个方法，轮播图将不会自动滚动。
mBanner.startTurning(3600);

//中止轮播图的自动滚动
mBanner.stopTurning();

//设置轮播图的滚动速度
mBanner.setScrollDuration(500);

//设置轮播图的点击事件
mBanner.setOnPageClickListener(new CustomBanner.OnPageClickListener<String>() {
    @Override
    public void onPageClick(int position, String str) {
     //position 轮播图的第几个项
     //str 轮播图当前项对应的数据
    }
});
复制代码

以上是CustomBanner的主要经常使用方法，更多方法请查看源码。

3）、CustomBanner的不少方法都支持方法的链式调用，好比如下的方法能够这样调用。

mBanner.setPages(参数, 参数).setIndicatorRes(参数, 参数).setIndicatorGravity(参数).startTurning(参数);
复制代码

效果图

CustomBanner的使用就介绍到这里了，你们在使用中若是发现什么问题或是有什么建议，欢迎评论留言。

文章已同步到个人CSDN博客