效果图

注意：0.0.5版本开始，IndicatorView更新

版本更新内容点击查看

使用步骤

Step 1.依赖banner

    repositories {        mavenCentral()    }dependencies{//已迁移至mavenCentral    implementation'io.github.zguop:pager2Banner:1.0.5'}

compile project(':pager2banner')

Step 2.xml

     <com.to.aboomy.pager2banner.Bannerandroid:id="@+id/banner"android:layout_width="match_parent"android:layout_height="150dp"/>

Step 3.自定义RecyclerView.Adapter

//自定义adapterpublicclassImageAdapterextendsRecyclerView.Adapter<RecyclerView.ViewHolder>//或者使用其他三方框架，都是支持的，如：BRVAHpublicclassImageAdapterextendsBaseQuickAdapter<String,BaseViewHolder> {publicImageAdapter() {super(R.layout.item_image);    }@Overrideprotectedvoidconvert(@NonNullBaseViewHolderhelper,Stringitem) {Glide.with(mContext)                .load(item)                .into((ImageView)helper.getView(R.id.img));    }}

Step 4.在页面中使用Banner

@OverrideprotectedvoidonCreate(BundlesavedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);banner =findViewById(R.id.banner);//使用内置IndicatorIndicatorViewindicator =newIndicatorView(this)              .setIndicatorColor(Color.DKGRAY)              .setIndicatorSelectorColor(Color.WHITE);//创建adapterImageAdapteradapter =newImageAdapter();//传入RecyclerView.Adapter 即可实现无限轮播banner.setIndicator(indicator)              .setAdapter(adapter);    }

简单设置一屏三页效果

//设置左右页面露出来的宽度及item与item之间的宽度.setPageMargin(UIUtil.dip2px(this,20),UIUtil.dip2px(this,10))//内置ScaleInTransformer，设置切换缩放动画.setPageTransformer(true,newScaleInTransformer())

支持访魅族样式

//单独设置OverlapSliderTransformer，项目里有，可以拷贝到项目中使用 kotlin实现的-。- .addPageTransformer(newOverlapSliderTransformer(banner.getViewPager2().getOrientation(),0.25f,0,1,0))

关于ViewPager切换动画

介绍一下 IndicatorView

    .setIndicatorRatio(1f)//ratio，默认值是1 ，也就是说默认是圆点，根据这个值，值越大，拉伸越长，就成了矩形，小于1，就变扁了呗    .setIndicatorRadius(2f)// radius 点的大小    .setIndicatorSelectedRatio(3)     .setIndicatorSelectedRadius(2f)    .setIndicatorStyle(IndicatorView.IndicatorStyle.INDICATOR_BIG_CIRCLE)

如何自定义Indicator

/** * 可以实现该接口，自定义Indicator 可参考内置的{@link IndicatorView} */publicinterfaceIndicator {/**     * 当数据初始化完成时调用     *     * @param pagerCount pager数量     */voidinitIndicatorCount(intpagerCount);/**     * 返回一个View，添加到banner中     */ViewgetView();/**     * banner是一个RelativeLayout，设置banner在RelativeLayout中的位置，可以是任何地方     */RelativeLayout.LayoutParamsgetParams();voidonPageScrolled(intposition,floatpositionOffset,@PxintpositionOffsetPixels);voidonPageSelected(intposition);voidonPageScrollStateChanged(intstate);}//举个栗子publicclassIndicatorViewextendsViewimplementsIndicator{@OverridepublicvoidinitIndicatorCount(intpagerCount) {this.pagerCount =pagerCount;setVisibility(pagerCount >1 ?VISIBLE :GONE);requestLayout();        }@OverridepublicViewgetView() {returnthis;        }/**          * 控制Indicator在Banner中的位置，开发者自行实现          */@OverridepublicRelativeLayout.LayoutParamsgetParams() {if (params ==null) {params =newRelativeLayout.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT,ViewGroup.LayoutParams.WRAP_CONTENT);params.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM);params.addRule(RelativeLayout.CENTER_HORIZONTAL);params.bottomMargin =dip2px(10);            }returnparams;        }/**          * banner切换时同步回调的三个方法          */@OverridepublicvoidonPageScrolled(intposition,floatpositionOffset,intpositionOffsetPixels) {selectedPage =position;offset =positionOffset;invalidate();        }@OverridepublicvoidonPageSelected(intposition) {        }@OverridepublicvoidonPageScrollStateChanged(intstate) {        }}

Banner提供的方法介绍，banner未提供任何自定义属性

内置IndicatorView使用方法介绍，没有提供任何自定义属性

总结