YCBanner轮播图
目录介绍
- 1.功能说明
- 2.ViewPager轮播图使用说明
- 3.跑马灯使用说明
- 4.RecyclerView轮播图
- 5.图片展示
- 6.其他介绍
1.功能说明
1.1 基础功能介绍
- 1.1 自定义轮播图,可以设置轮播红点或者轮播数字,多种指示器,并且灵活设置位置
- 1.2 支持多种轮播图适配器,无限轮播adapter,静态管理adapter,和动态管理adapter。支持多种场合使用。
- 1.3 支持自定义hintView,十分灵活,拓展性强
- 1.4 无限循环自动轮播、手指按下暂停轮播、抬起手指开始轮播
- 1.5 优化:在页面onPause中调用停止轮播,在页面onResume中调用开始轮播
- 1.6 支持监听item点击事件,支持轮播图中ViewPager的滑动监听事件
- 1.7 不仅支持轮播图,还支持引导页面,十分方便
- 1.8 后期增加使用recyclerView设置轮播图。已经封装到GalleryRecyclerView中,链式调用十分方便
- 1.9 GalleryRecyclerView轮播图支持设置轮播间隔时间,设置滑动速度,设置缩放比例因子
- 如何引用:直接在项目build文件中添加库即可:compile 'cn.yc:YCBannerLib:1.3.9'
1.2 该库的优势
2.ViewPager轮播图使用说明
- 2.1 关于具体的使用方法,可以直接参考代码
- 2.2 在布局中写,可以设置选择的属性值
<com.yc.cn.ycbannerlib.BannerView
xmlns:app="http://schemas.android.com/apk/res-auto"
android:id="@+id/banner"
android:layout_width="match_parent"
android:layout_height="200dp"
app:hint_color="@color/colorAccent"
app:hint_gravity="center"
app:hint_mode="point"
app:play_delay="2000"/>
- 2.3 在代码中,自定义adapter适配器,继承自己合适的adapter。目前支持继承动态管理adapter,静态管理adapter,和无限轮播adapter
private void initBanner() {
banner = (BannerView) findViewById(R.id.banner);
//设置轮播时间
banner.setPlayDelay(2000);
//设置轮播图适配器,必须
banner.setAdapter(new ImageNormalAdapter());
//设置位置
banner.setHintGravity(1);
//设置指示器样式
banner.setHintMode(BannerView.HintMode.TEXT_HINT);
//判断轮播是否进行
boolean playing = banner.isPlaying();
//轮播图点击事件
banner.setOnBannerClickListener(new OnBannerClickListener() {
@Override
public void onItemClick(int position) {
Toast.makeText(FirstActivity.this,position+"被点击呢",Toast.LENGTH_SHORT).show();
}
});
//轮播图滑动事件
banner.setOnPageListener(new OnPageListener() {
@Override
public void onPageChange(int position) {
}
});
}
private class ImageNormalAdapter extends AbsStaticPagerAdapter {
@Override
public View getView(ViewGroup container, int position) {
ImageView view = new ImageView(container.getContext());
view.setScaleType(ImageView.ScaleType.CENTER_CROP);
view.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
ViewGroup.LayoutParams.MATCH_PARENT));
view.setImageResource(imgs[position]);
return view;
}
@Override
public int getCount() {
return imgs.length;
}
}
- 2.4 关于轮播图属性
- 关于暂停和开始轮播方法,建议加上
@Override
protected void onPause() {
super.onPause();
if(banner!=null){
//停止轮播
banner.pause();
}
}
@Override
protected void onResume() {
super.onResume();
if(banner!=null){
//开始轮播
banner.resume();
}
}
- 2.5 如何显示红点,文字,自定义icon等
- a.设置文本添加代码:
- banner.setHintView(new TextHintView(this));
- b.设置自定义icon添加代码:
- banner.setHintView(new IconHintView(this,R.drawable.point_focus,R.drawable.point_normal));
- c.默认不添加该方法则是显示圆点
- 请参考代码,已经做出了很详细的注释
3.跑马灯使用说明
3.1 在布局中添加代码
<!--上下滚动TextView-->
<com.yc.cn.ycbannerlib.marquee.MarqueeView
xmlns:app="http://schemas.android.com/apk/res-auto"
android:id="@+id/marqueeView"
android:layout_width="match_parent"
android:layout_marginTop="10dp"
android:layout_height="40dp"
android:layout_marginLeft="10dp"
android:layout_marginRight="10dp"
android:layout_gravity="center_vertical"
app:paddingStart="0dp"
app:mvAnimDuration="1000"
app:mvInterval="2000"
app:mvTextColor="#464C4E"
app:mvTextSize="16sp"
app:mvSingleLine="true"/>
3.2 使用
List<CharSequence> list = getMarqueeTitle();
//根据公告字符串列表启动轮播
marqueeView.startWithList(list);
//设置点击事件
marqueeView.setOnItemClickListener(new MarqueeView.OnItemClickListener() {
@Override
public void onItemClick(int position, TextView textView) {
}
});
4.RecyclerView轮播图
4.1 RecyclerView轮播图简单使用
<com.yc.gallerybannerlib.GalleryRecyclerView
android:layout_marginTop="35dp"
android:id="@+id/recyclerView"
android:layout_width="match_parent"
android:layout_height="200dp"/>
private void initRecyclerView() {
Snap3Adapter adapter = new Snap3Adapter(this);
adapter.setData(getData());
mGalleryRecyclerView.setDelayTime(3000)
.setFlingSpeed(0)
.setDataAdapter(adapter)
.setSelectedPosition(100)
.setCallbackInFling(false)
.setOnItemSelectedListener(new GalleryRecyclerView.OnItemSelectedListener() {
@Override
public void onItemSelected(RecyclerView recyclerView, View item, int position) {
Log.e("onItemSelected-----",position+"");
//设置高斯模糊背景
setBlurImage(true);
}
})
.setSize(adapter.getData().size())
.setUp();
}
- 注意要点:recyclerView轮播要是无限轮播,必须设置两点,很关键。
- 第一处是getItemCount() 返回的是Integer.MAX_VALUE。这是因为广告轮播图是无限轮播,getItemCount()返回的是Adapter中的总项目数,这样才能使RecyclerView能一直滚动。
- 第二处是onBindViewHolder()中的 position%list.size() ,表示position对图片列表list取余,这样list.get(position%list.size())才能按顺序循环展示图片。
4.2 RecyclerView实现平滑滚动,图片剧中效果
- 如果不想设置轮播图,只想滚动。则可以直接套用GalleryLayoutManager
GalleryLayoutManager manager = new GalleryLayoutManager(LinearLayoutManager.HORIZONTAL);
manager.attach(recyclerView,100);
//如果想缩放,可以直接设置缩放比例因子即可
manager.setItemTransformer(new GalleryScaleTransformer( 0.2f));
recyclerView.setLayoutManager(manager);
Snap3Adapter adapter = new Snap3Adapter(this);
adapter.setData(getData());
recyclerView.setAdapter(adapter);
4.3 关于自定义SnapHelper类
- 有的时候原生LinearSnapHelper或者PagerSnapHelper无法满足我的需求,比如要设置滑动卡片左边对齐,或者右边对齐,或者居中模式;如果想要修改一下速率,或者一次滑动只能滑动一个item,那么就需要自定义呢
- 具体实现可以看我的项目demo,看看下面的效果图
- 关于SnapHelper类源码深度解析,可以看我的这篇博客:https://www.jianshu.com/p/9b8e0696802d
5.图片展示