一个很Nice的Android Banner轮播图库

Android小白一枚,最近项目中有一个轮播图的需求,网上搜了很多资料,也看了多开源库,但不是bug多就是库不维护。后来在GitHub上找到一个很棒的轮播图–BannerViewPager库推荐个大家。

它的使用方法很简单,也是我看过其他库里边使用最简单的一个。

1.gradle中添加依赖

在项目的root build.gradle中添加如下配置,这个配置是需要添加到项目根目录下的gradel文件中的。

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

然后在项目app目录下的gradle中添加BannerViewPager的依赖:

implementation 'com.github.zhpanvip:BannerViewPager:3.4.0'

然后在Activity的布局文件中添加BannerViewPager:

    <com.zhpan.bannerview.BannerViewPager
            android:id="@+id/banner_view"
            android:layout_width="match_parent"
            android:layout_margin="10dp"
            android:layout_height="160dp" />

2.Banner的页面布局

这个是我们Banner的item页面布局文件,Item的布局必须是"match_parent",否则会抛出一个IllegalStateException.

    <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ImageView
        android:id="@+id/banner_image"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:scaleType="centerCrop" />

</RelativeLayout>

3.编写Adapter

创建一个BannerAdapter并集成BaseBannerAdapter,BaseBannerAdapter是一个泛型类,需要指定Item的数据的实体类。然后重写getLayoutId方法,返回上边写的布局文件。最后重写bindData方法,并这个方法里边绑定数据即可

public class BannerAdapter extends BaseBannerAdapter<BannerData> {

    @Override
    protected void bindData(BaseViewHolder<BannerData> holder, BannerData data, int position, int pageSize) {
        ImageView imageView = holder.findViewById(R.id.banner_image);
        Glide.with(imageView).load(data.getImageUrl()).into(imageView);
    }

    @Override
    public int getLayoutId(int viewType) {
        return R.layout.item_banner;
    }
}

(5)在Activity中创建BannerViewPager

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        BannerViewPager<BannerData> bannerViewPager = findViewById(R.id.banner_view);
        bannerViewPager.setAdapter(new BannerAdapter())
                .setLifecycleRegistry(getLifecycle())
                .create(getBannerData());
    }

    private List<BannerData> getBannerData() {
        List<BannerData> list = new ArrayList<>();
        BannerData bannerData1 = new BannerData();
        bannerData1.setImageUrl("https://ss1.baidu.com/9vo3dSag_xI4khGko9WTAnF6hhy/zhidao/pic/item/a044ad345982b2b75133e15130adcbef77099bf3.jpg");
        BannerData bannerData2 = new BannerData();
        bannerData2.setImageUrl("https://ss0.baidu.com/94o3dSag_xI4khGko9WTAnF6hhy/zhidao/pic/item/d009b3de9c82d1582442d267820a19d8bd3e4220.jpg");
        BannerData bannerData3 = new BannerData();
        bannerData3.setImageUrl("https://ss3.baidu.com/9fo3dSag_xI4khGko9WTAnF6hhy/zhidao/pic/item/0824ab18972bd407ff38f2b378899e510eb30984.jpg");
        list.add(bannerData1);
        list.add(bannerData2);
        list.add(bannerData3);
        return list;
    }

因为上边代码中的数据是写死的,可以直接通过create(getBannerData())方法创建数据。但是如果数据是从服务器拿到的则可以调用create()方法,等到拿到服务器数据后在通过refreshData方法刷新即可。代码如下:

  bannerViewPager.setAdapter(new BannerAdapter())
                .setLifecycleRegistry(getLifecycle())
                .create();
  bannerViewPager.refreshData(dataList);

这样,就完成了一个自动无限轮播的ViewPager了,并且带有一个默认的圆形指示器,效果如下图所示:

一个很Nice的Android Banner轮播图库
是不是非常简单呢?当然,这还是最基本的用法,这个库还提供了很多的配置,包括页面样式,还有很多炫酷的指示器样式。下边稍微修改一下代码:

bannerViewPager.setAdapter(new BannerAdapter())
                .setLifecycleRegistry(getLifecycle())
                .setIndicatorSliderColor(getResources().getColor(R.color.purple_200), getResources().getColor(R.color.purple_500))
                .setIndicatorSlideMode(IndicatorSlideMode.WORM)
                .setPageStyle(PageStyle.MULTI_PAGE_OVERLAP)
                .setRevealWidth(getResources().getDimensionPixelOffset(R.dimen.margin))
                .create(getBannerData());

相比上边仅仅添加了四行代码,再来看效果:
一个很Nice的Android Banner轮播图库
哈哈,有没有很酷!这个库支持的效果还不仅仅是这些,具体效果大家可以点击BannerViewPager链接到GitHub查看。
最后,欢迎大家点赞呀!

上一篇:BIOS 品牌快捷键


下一篇:Android Bug BaseExpandableListAdapter, getChildView