打造一个轻量级,简单,易用的Android Banner框架

打造一个轻量级,简单,易用的Android Banner框架

由于本人在写一个项目(项目地址: https://github.com/xfhy/Daily )的时候,需要用到banner,用于显示首页的轮播图,但是我又不想让项目导入过多的开源框架,于是自己动手撸一个.我设计得很简单,可能该存在很多的不足,欢迎大家批评指正.该框架地址:https://github.com/xfhy/EasyBanner

no Picture no bb

已实现的功能

自动轮播

无限左划右划

加载网络图片交给外部调用者（实现解耦），加载标题

底部小白点可切换，大小可换，数量可动态增加

触摸时不能滑动

实现banner的item点击事件

广告数目可以随意

可以在代码中生成banner，也可以在xml布局中生成

简单使用

使用前将该EasyBanner 这个module导入到自己的项目，并在app主项目中依赖此module.

1.在xml中使用

<com.xfhy.easybanner.ui.EasyBanner
android:id="@+id/eb_banner"
android:layout_width="match_parent"
android:layout_height="200dp"/>

//可以在布局里面写
mBanner = (EasyBanner) findViewById(R.id.eb_banner);
//设置图片url和图片标题
mBanner.initBanner(getImageUrlData(), getContentData());

2.在代码中使用banner

//也可以直接动态生成
EasyBanner easyBanner = new EasyBanner(this);
//设置图片url和图片标题
easyBanner.initBanner(getImageUrlData(), getContentData());
mRootView.addView(easyBanner,new LinearLayout.LayoutParams(LinearLayout
.LayoutParams.MATCH_PARENT, DensityUtil.dip2px(this,200)));

3.设置图片加载器（必须）

//设置图片加载器
mBanner.setImageLoader(new EasyBanner.ImageLoader() {
@Override
public void loadImage(ImageView imageView, String url) {
Glide.with(mContext).load(url).into(imageView);
}
});

4.实现点击事件(非必须)

//监听banner的item点击事件
mBanner.setOnItemClickListener(new EasyBanner.OnItemClickListener() {
@Override
public void onItemClick(int position, String title) {
Toast.makeText(MainActivity.this, "position:"+position+"   title:"+title, Toast
.LENGTH_SHORT).show();
}
});

基本使用就是这样，详情请看demo: https://github.com/xfhy/EasyBanner

原理

首先我们分析,banner是可以随便左右滑动的,而且可以点击.所以我想到用ViewPager来实现,然后banner里面的图片我就在ViewPager的每个页面中放一个ImageView;接下来就是上面的标题了,我直接用的TextView,因为同时显示的标题只有1个,所以用一个textView就够了;然后最底部的小圆点,我是这样做的:用一个LinearLayout将它们全部装进来,有多少我装多少,这样就可以动态扩展.至于小圆点可以变换颜色直接用selector实现.

请看布局代码

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:id="@+id/banner_root_view"
android:layout_width="match_parent"
android:layout_height="200dp">

<!--轮播图布局-->

<!--用于播放广告轮播图-->
<android.support.v4.view.ViewPager
android:id="@+id/vp_banner"
android:layout_width="match_parent"
android:layout_height="match_parent"/>

<!--标题-->
<TextView
android:id="@+id/tv_banner_content"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginBottom="10dp"
android:layout_marginStart="10dp"
android:clickable="false"
android:ellipsize="end"
android:enabled="false"
android:maxLines="2"
android:textColor="@android:color/white"
android:textSize="20sp"
app:layout_constraintBottom_toTopOf="@+id/ll_banner_point"/>

<!--下方的小圆点布局-->
<LinearLayout
android:id="@+id/ll_banner_point"
android:layout_width="match_parent"
android:layout_height="20dp"
android:layout_marginBottom="10dp"
android:clickable="false"
android:gravity="center"
android:orientation="horizontal"
app:layout_constraintBottom_toBottomOf="parent"/>

</android.support.constraint.ConstraintLayout>

2.初始化:传入了多少个数据就初始化多少个ImageView,然后放进图片List中先保存起来,并且循环遍历让外部去实现该图片的加载(加载网络图片);循环遍历时将小圆点依次加入到底部的LinearLayout中;设置ViewPager的页面切换监听器,为了切换选择界面的小圆点的颜色;并设置ViewPager的当前item为一个很大的数,这样就可以无限地左滑右滑了(哈哈,有点投机取巧….)

下面是初始化代码

/**
* 初始化数据
*/
private void initData() {
imageViewList = new ArrayList<>();
View pointView;

int bannerSize = imageUrlList.size();
for (int i = 0; i < bannerSize; i++) {
//加载图片
ImageView imageView = new ImageView(getContext());
imageView.setScaleType(ImageView.ScaleType.CENTER_CROP);

//让外部去实现图片加载，实现解耦
if (imageLoader != null) {
imageLoader.loadImage(imageView, imageUrlList.get(i));
}

imageViewList.add(imageView);

//底部的小白点
pointView = new View(getContext());
//设置背景
pointView.setBackgroundResource(R.drawable.selector_banner_point);
//设置小圆点的大小
LinearLayout.LayoutParams layoutParams = new LinearLayout.LayoutParams(DensityUtil
.dip2px(getContext(), POINT_DEFAULT_SIZE), DensityUtil.dip2px(getContext(),
POINT_DEFAULT_SIZE));

//除第一个以外，其他小白点都需要设置左边距
if (i != 0) {
layoutParams.leftMargin = DensityUtil.dip2px(getContext(), POINT_DEFAULT_SIZE / 2);
pointView.setEnabled(false); //默认小白点是不可用的
}

pointView.setLayoutParams(layoutParams);
mPointLayout.addView(pointView);  //添加到linearLayout中
}

//延时
mHandler.postDelayed(delayRunnable, BANNER_SWITCH_DELAY_MILLIS);

BannerAdapter bannerAdapter = new BannerAdapter();
mViewPager.setAdapter(bannerAdapter);
//页面切换监听器
mViewPager.addOnPageChangeListener(this);

//将ViewPager的起始位置放在  一个很大的数处，那么一开始就可以往左划动了   那个数必须是imageUrlList.size()的倍数
int remainder = (Integer.MAX_VALUE / 2) % imageUrlList.size();
mViewPager.setCurrentItem(Integer.MAX_VALUE / 2 - remainder);
//文本默认为第一项
mContent.setText(contentList.get(0));
mPointLayout.getChildAt(0).setEnabled(true);
}

3.实现自动延时切换,这个就比较简单了,直接用Handler的postDelayed()就行.当执行完这次任务,又进行一次postDelayed(),这样就可以无限轮播了.

/**
* 延时的任务
*/
Runnable delayRunnable = new Runnable() {
@Override
public void run() {
//用户在触摸时不能进行自动滑动
if (!isTouched) {
//ViewPager设置为下一项
mViewPager.setCurrentItem(mViewPager.getCurrentItem() + 1);
}
//继续延迟切换广告
mHandler.postDelayed(delayRunnable, BANNER_SWITCH_DELAY_MILLIS);
}
};

4.最后是ViewPager的adapter

首先,由于之前我们设置的初始item值比较大,所以getCount()也返回一个很大的数.这样就可以随便滑动了.

然后再设置ImageView的点击事件,即可简单地实现ViewPager的item点击事件….这里感觉有点不妥.

之前我是用onTouchEvent()来实现的点击事件,但是这样也不是很妥.

关于ViewPager的item点击事件,暂时没有想到其他的好方法,大家有什么好方法么?

/**
* banner中ViewPager的adapter
*/
private class BannerAdapter extends PagerAdapter {

/**
* 返回资源一共有的条目数
*/
@Override
public int getCount() {
return Integer.MAX_VALUE;
}

/**
* 复用判断逻辑
*/
@Override
public boolean isViewFromObject(View view, Object object) {
return view == object;
}

@Override
public Object instantiateItem(ViewGroup container, int position) {
final int newPosition = position % imageUrlList.size();
ImageView imageView = imageViewList.get(newPosition);

//设置点击事件
imageView.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
//回调
if (listener != null) {
listener.onItemClick(newPosition, contentList.get(newPosition));
}
}
});
container.addView(imageView);
return imageView;
}

@Override
public void destroyItem(ViewGroup container, int position, Object object) {
container.removeView((View) object);
}
}

总结

基本情况就是这样,实现得比较简单,可能还有很多问题存在.欢迎大家指正.框架地址:https://github.com/xfhy/EasyBanner