/Android-ConvenientBanner

Simple and convenient banner, loop viewpager with 3D effects

Primary LanguageJava

Android Gems

ConvenientBanner

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

Demo

用模拟器运行的效果,鼠标拨动和模拟器太卡等原因,实际效果比效果图更炫哦~~

demo是用Module方式依赖,你也可以使用gradle 依赖:

   compile 'com.bigkoo:convenientbanner:1.1.4'
   compile 'com.bigkoo:convenientbanner:2.0.0'//这个版本是令人失望的,一二页会有空白问题,容我再调优下
Config in xml
<com.bigkoo.convenientbanner.ConvenientBanner
        xmlns:app="http://schemas.android.com/apk/res-auto"
        android:id="@+id/convenientBanner"
        android:layout_width="match_parent"
        android:layout_height="200dp"
        app:canLoop="true" //控制循环与否
/>

config in java code

//自定义你的Holder,实现更多复杂的界面,不一定是图片翻页,其他任何控件翻页亦可。
convenientBanner.setPages(
                new CBViewHolderCreator<LocalImageHolderView>() {
                    @Override
                    public LocalImageHolderView createHolder() {
                        return new LocalImageHolderView();
                    }
                }, localImages)
                //设置两个点图片作为翻页指示器,不设置则没有指示器,可以根据自己需求自行配合自己的指示器,不需要圆点指示器可用不设
                .setPageIndicator(new int[]{R.drawable.ic_page_indicator, R.drawable.ic_page_indicator_focused})
                //设置指示器的方向
                .setPageIndicatorAlign(ConvenientBanner.PageIndicatorAlign.ALIGN_PARENT_RIGHT)
                //设置翻页的效果,不需要翻页效果可用不设
                .setPageTransformer(Transformer.DefaultTransformer);
//        convenientBanner.setManualPageable(false);//设置不能手动影响

public class LocalImageHolderView implements CBPageAdapter.Holder<Integer>{
    private ImageView imageView;
    @Override
    public View createView(Context context) {
        imageView = new ImageView(context);
        imageView.setScaleType(ImageView.ScaleType.FIT_XY);
        return imageView;
    }

    @Override
    public void UpdateUI(Context context, final int position, Integer data) {
        imageView.setImageResource(data);
    }
}

Thanks

更新说明

v1.1.0 修复了往前滑动最后一页会变空白页的BUG
v1.1.1 修复第三方图库下载setTag出错的BUG

v1.1.2

  • 修复下拉刷新自动翻页偶尔失效停止BUG
  • 提供onPageChangeListener的API调用

v1.1.3

  • 循环控制,可以设置为不循环模式
  • 加入OnItemClcikListener监听器,修复原先点击图片position失准BUG
  • 调整notifyDataSetChanged函数,并加入notifyDataSetAdd函数

v1.1.4

  • getCurrentPageIndex函数改为getCurrentItem
  • 加入setcurrentitem函数

v2.0.0

  • 重新修改循环逻辑
  • 解决卡顿和白屏现象
  • Demo中加入下拉刷新和控件左右拨动冲突方案