• Stars
    star
    101
  • Rank 338,166 (Top 7 %)
  • Language
    Java
  • Created over 7 years ago
  • Updated over 6 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Android轮播图控件,支持任何View的轮播,而不仅仅是图片(ImageView),完全自定义的轮播指示器和轮播图样式,使用非常简单。

CustomBanner

Android轮播图控件,支持任何View的轮播,而不仅仅是图片(ImageView),完全自定义的轮播指示器和轮播图样式,使用非常简单。下面是CustomBanner具体使用讲解:

1、引入依赖

在Project的build.gradle在添加以下代码

  allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }

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

  dependencies {
            compile 'com.github.donkingliang:CustomBanner:1.1.3'
    }

2、编写布局

	<!-- 设置普通指示器 -->
	<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" //指示器的位置 有左。中、右三个值
	    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"/> //指示器类型 没有指示器

3、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);
mBanner.setIndicator(Drawable select, Drawable unSelect);
      
//设置指示器的指示点间隔,只有指示器为普通指示器(ORDINARY)时有用。
//这个方法跟在布局中设置app:indicatorInterval是一样的。
mBanner.setIndicatorInterval(20)

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

//设置轮播图自动滚动轮播,参数是轮播图滚动的间隔时间
//轮播图默认是不自动滚动的,如果不调用这个方法,轮播图将不会自动滚动。
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(参数);

效果图

在我的博客中对该轮播图控件的实现和核心代码有详细的分析讲解,欢迎大家访问我的博客
Android轮播图控件的实现详解

More Repositories

1

ConsecutiveScroller

ConsecutiveScrollerLayout是Android下支持多个滑动布局(RecyclerView、WebView、ScrollView等)和普通控件(TextView、ImageView、LinearLayou、自定义View等)持续连贯滑动的容器,它使所有的子View像一个整体一样连续顺畅滑动。并且支持布局吸顶功能。
Java
2,457
star
2

GroupedRecyclerViewAdapter

GroupedRecyclerViewAdapter可以很方便的实现RecyclerView的分组显示,并且每个组都可以包含组头、组尾和子项;可以方便实现多种Type类型的列表,可以实现如QQ联系人的列表一样的列表展开收起功能,还可以实现头部悬浮吸顶功能等。
Java
1,606
star
3

LabelsView

Android的标签列表控件。可以设置标签的选中效果。 可以设置标签的选中类型:不可选中、单选、限数量多选和不限数量多选等, 并支持设置必选项、单行显示、最大显示行数等功能。
Java
989
star
4

ImageSelector

Android图片选择器,仿微信的图片选择器的样式和效果。支持图片的单选、限数量的多选和不限数量的多选,支持图片剪切。支持图片预览和图片文件夹的切换。支持在选择图片时调用相机拍照,也支持不用打开相册直接调用相机拍照。
Java
753
star
5

RadarView

Android自定义View 雷达扫描效果
Java
126
star
6

Photograph

android 调用相机拍照。适配到Android 10
Java
65
star
7

HeaderViewAdapter

HeaderViewAdapter可以对已有的RecyclerView.Adapter进行包装,使其具备给列表添加头部和添加尾部的功能。就相当于给RecyclerView扩展了类似ListView的addHeaderView和addFooterView的功能。
Java
48
star
8

RefreshLayout

Android 下拉刷新和上拉加载更多框架。RefreshLayout可以用于嵌套任意的View。比如RecyclerView、ScrollView、WebView等,实现下拉刷新和上拉加载功能。可以设置空布局和自定义头部尾部View等。
Java
13
star
9

EmptyAdapter

带空布局的RecyclerView Adapter
Java
4
star
10

VariedItemDecoration

VariedItemDecoration是通用的Recycler ItemDecoration。可实现在一个列表里显示多种不同样式的ItemDecoration;可定制每个item的ItemDecoration的显示和样式。使用方便,并且提供非常简单的自定义ItemDecoration方式,根据position返回对应item的装饰drawable和大小。
Java
4
star