文章概述：

本篇文章記錄開源的Banner庫：android-banner 的使用。android-banner實現了一般banner循環輪播的效果，一頁只顯示一張圖片，也可以一頁顯示一張圖和相鄰兩個圖片的一部分，此項目僅僅是banner展示圖片，沒有多余的諸如指示器、頁面切換動畫等效果代碼，詳見效果圖和案例代碼。

項目地址：https://github.com/cnlius/android-banner

overview

效果圖

usage

Gradle

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

dependencies {
    compile 'com.github.cnlius:android-banner:0.0.2'
}

ProGuard

-keep class com.lw.banner.** {*;}

Layout

<com.lw.banner.Banner
    android:id="@+id/banner"
    android:layout_width="match_parent"
    android:layout_height="160dp" />

xml中可設置的一些屬性

案例：xml中設置循環輪播時間間隔

<com.lw.banner.Banner
    android:id="@+id/banner"
    android:layout_width="match_parent"
    android:layout_height="160dp"
    app:delayTime="1000"/>

Code

List<String> urls=getUrls();
banner.setImages(urls)
        .setImageLoader(new GlideImageLoader())
        .init();       

代碼中可以配置的一些屬性：

banner.setImages(Arrays.asList(imgRes)) //設置圖片資源
        //.setImageLoader(new FrescoImageLoader()) // 設置fresco圖片加載器
        .setImageLoader(new GlideImageLoader()) //設置Glide圖片加載器
        //.setPageTransformer(true, new PageScaleYTransformer()) //頁面切換動畫
        .setOnItemClickListener(new Banner.OnItemClickListener() {
            @Override
            public void callBack(int position) {
                Toast.makeText(MainActivity.this, "position=" + position, Toast.LENGTH_SHORT).show();
            }
        }) //設置banner點擊監聽
        //.setScrollable(false) // 禁用banner手動滑動
        //.setDelayTime(1000) // 循環輪播時間間隔
        //.setPageLimit(4) // 設置預加載頁面數量
        //.setPageMargin(20) // banner頁面之間的間隔
        //.setRightPageWidth(50) // 當前頁面右側頁面可以顯示的寬度
        //.setLeftPageWidth(50) // 當前頁面左側頁面可以顯示的寬度
        //.setEmptyImageRes(R.mipmap.no_banner) // banner為空時占位圖
        //.setEmptyImageScaleType(ImageView.ScaleType.FIT_CENTER) // 占位圖的縮放類型,默認FIT_XY
        .isAutoPlay(true) // 設置自動循環輪播
        .init();
// 拿到占位圖ImageView對象
ImageView emptyView = mBinding.banner2.getEmptyView();
emptyView.setImageResource(R.mipmap.mn_01);
// 拿到BannerViewPager對象
BannerViewPager bannerViewPager = mBinding.banner2.getBannerViewPager();      

生命周期中控制循環輪播的周期

@Override
protected void onStart() {
    super.onStart();
    //開始輪播
    banner.startAutoPlay();
}
@Override
protected void onStop() {
    super.onStop();
    //結束輪播
    banner.stopAutoPlay();
}

參考

https://github.com/youth5201314/banner