效果演示
上圖這個效果你可以于淘寶,愛奇藝,華為應用商店等一系列熱門或者不熱門的APP中看到,因為使用Banner可以通過固定大小的位置動態或者靜態的向用戶展示多條甚至幾十條(雖然沒人這樣子做)圖文數據,對于我自己來說也經常會使用到Banner來展示廣告數據或者手機啟動引導界面,所以就有了現在這個SimpleBanner庫,它肯定不是最完美的,但是我希望它是有用的。
使用
- 在你project的
build.gradle
的repositories
里面添加:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}```
2. 在你所需的module的```build.gradle```里面添加依賴:
dependencies {
compile 'com.github.AmatorLee:SimpleBanner:1.0.0'
}```
- 在你需要展示Banner數據的xml文件中引入:
<com.amator.simplebanner.widget.SimpleBanner
android:id="@+id/banner_simple"
android:layout_width="match_parent"
android:layout_height="200dp">
</com.amator.simplebanner.widget.SimpleBanner>```
4. 在Activity或者Fragment中配置SimpleBanner:
/**
* 測試本地圖片資源,圖片較大,造成開銷大
/
private int[] imaRes = {R.drawable.a123, R.drawable.color, R.drawable.flash, R.drawable.zhixiao, R.drawable.xiaozhi};
private SimpleBanner mBanner;
/*
* 默認圖片資源(圖片URL地址)
/
private String[] defaultUrl = new String[]{
"http://g.hiphotos.baidu.com/imgad/pic/item/a8773912b31bb051be533b24317adab44aede043.jpg",
"http://g.hiphotos.baidu.com/imgad/pic/item/c75c10385343fbf22c362d2fb77eca8065388fa0.jpg",
"http://liaoning.sinaimg.cn/2014/1111/U10435P1195DT20141111220802.jpg",
"http://photocdn.sohu.com/20151124/mp43786429_1448294862260_4.jpeg",
"http://h.hiphotos.baidu.com/image/pic/item/faedab64034f78f0b00507c97e310a55b3191cf9.jpg"};
/*
* 測試文字提示
*/
private String[] titleRes = {"深色", "淺色", "動物", "宋智孝", "宋智孝"};
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//加載本地圖片
List<Integer> mDatas = new ArrayList<>();
for (int i = 0; i < imaRes.length; i++) {
mDatas.add(imaRes[i]);
}
//加載網絡圖片
List<String> mImageRes = new ArrayList<>();
for (int i = 0; i < defaultUrl.length; i++) {
mImageRes.add(defaultUrl[i]);
}
List<String> tips = new ArrayList<>();
for (int i = 0; i < titleRes.length; i++) {
tips.add(titleRes[i]);
}
//1.寫在布局文件中
mBanner = (SimpleBanner) findViewById(R.id.banner_simple);
mBanner.setImageRes(mImageRes)
.start();//調用則表示允許自動循環播放
//2.代碼中直接使用
LinearLayout linearLayout = (LinearLayout) findViewById(R.id.ll_banner_container);
mBanner = SimpleBanner.createBanner(this)
.setImageRes(mImageRes);
mBanner.start();
LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, DisplayUtil.dp2px(this, 200));
linearLayout.addView(mBanner, params);
}
@Override
protected void onPause() {
super.onPause();
//釋放資源避免內存泄漏
mBanner.stop();
}```
就這樣就可以實現以下效果
可能有人會問,那么切換效果呢?,其實切換效果的實現很簡單,但是實現炫酷的切換效果需要大量是時間進行計算,同時對于部分APP來說是不合適的,所以我不打算提供多種切換效果,當然你可以自己實現然后調用
setBannerPageTranFormer(boolean reverseDrawingOrder, ViewPager.PageTransformer transformer)
即可。同時我推薦一個開源庫android-viewpager-transformers,感謝。
代碼分析
短短的使用步驟絞盡腦汁也寫不出來,所以直接show you the fuck codes就好。
在此之前我先簡單來說說SimpleBanner實現無限輪播的實現方式
現今gayhub上的banner開源庫主要分為兩大類:
- 使用ViewPager實現
- 自定義或者使用RecyclerView等實現
那么Simple是使用第一種方式,所以就結合代碼分析來說說第一種的套路吧:
既然知道了精髓是ViewPager,在確定ViewPager之后我們要考慮以下兩個問題
- 實現循環播放
- 如何進行自動循環
回答一
其實實現循環很簡單,只要在最后一張圖片滑動時把它下一張重新設置為第一張就可以實現“偽循環”,但是這樣重新滑進去會造成很不好的用戶體驗,所以我們給ViewPager的adapter設置一個很大的數,返回一個巨大的數值,通過與實際數量的求余就可以實現“無限循環”。
回答二
很多時候我們都會新建一個Handler
,然后再其實現方法里面對viewPager進行setCurrentItem,然后再界面跳轉完成后掩飾某個delayTime
不斷發送自身空消息就可以實現自動播放了,bug,還有更好的辦法嗎?知道我看到了達哥的《手把手教你用ViewPager自定義實現Banner輪播 》,找到了更好的寫法,當然思想是一樣的。
BannerViewPager
/**
* Created by AmatorLee on 2017/7/21.
*/
public class BannerViewPager extends ViewPager {
private int delayTime = 3000;//設置展示時間
private BannerDirection mBannerDirection = LEFT;//試著輪播方向
private boolean isAuto = true;//是否為自動輪播
public void setAuto(boolean auto) {
isAuto = auto;
}
public void setDelayTime(int delayTime) {
this.delayTime = delayTime;
}
public void setBannerDirection(BannerDirection bannerDirection) {
mBannerDirection = bannerDirection;
}
public BannerViewPager(Context context) {
super(context);
}
public BannerViewPager(Context context, AttributeSet attrs) {
super(context, attrs);
}
public void start() {
if (isAuto) {
//每次開始前先remove掉避免重復調用
removeCallbacks(mBannerTask);
postDelayed(mBannerTask, delayTime);
}
}
public void stop() {
removeCallbacks(mBannerTask);
}
private Runnable mBannerTask = new Runnable() {
@Override
public void run() {
bannerPlay();
}
};
private void bannerPlay() {
PagerAdapter adapter = getAdapter();
if (adapter != null) {
int count = adapter.getCount();
int currentItem = getCurrentItem();
switch (mBannerDirection) {
case LEFT:
currentItem++;
if (currentItem >= count) {
currentItem = 0;
}
break;
case RIGHT:
currentItem--;
if (currentItem < 0) {
currentItem = count - 1;
}
break;
}
setCurrentItem(currentItem);
}
start();
}
@Override
protected void onDetachedFromWindow() {
removeCallbacks(mBannerTask);
super.onDetachedFromWindow();
}
}```
如上所說,需要給Adapter設置一個很大的數```Integer.MAX_VALUE```
**BannerViewPager**
/**
- Created by AmatorLee on 2017/7/20.
*/
public class BannerAdapter extends PagerAdapter {
private List<View> mViews;
public static final String TAG = "BannerPagerAdapter";
private OnBannerClickListener mBannerClickListener;
private int pos;
public void setBannerClickListener(OnBannerClickListener bannerClickListener) {
mBannerClickListener = bannerClickListener;
}
public BannerAdapter(List<View> mViews) {
this.mViews = mViews;
}
@Override
public Object instantiateItem(ViewGroup container, int position) {
if (mViews == null || mViews.size() == 0) {
Log.d(TAG, "instantiateItem return");
return null;
}
final int pos = position % mViews.size();
View view = mViews.get(pos);
ViewGroup parent = (ViewGroup) view.getParent();
if (parent != null) {
parent.removeView(view);
}
view.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Log.d(TAG, "instantiateItem pos is :" + pos);
if (mBannerClickListener != null) {
mBannerClickListener.onBannerClick(pos);
}
}
});
container.addView(view);
return view;
}
@Override
public void destroyItem(ViewGroup container, int position, Object object) {
if (mViews == null || mViews.size() == 0) {
return;
}
int pos = position % mViews.size();
Log.d(TAG, "destroyItempos: " + pos);
container.removeView(mViews.get(pos));
}
@Override
public int getCount() {
return mViews == null ? 0 : Integer.MAX_VALUE;
}
@Override
public boolean isViewFromObject(View view, Object object) {
return view == object;
}
@Override
public int getItemPosition(Object object) {
return POSITION_NONE;
}
}其實看到上面的演示圖還有最后一個注意點就是指示器Indicator,我嘗試過自己自定義幾種類型的
BannerIndicator```,但是這樣做的話實現太多的子類,所以我采取代碼家AndroidImageSlider的寫法使用圖層Drawable動態實現。
總結
Banner幾乎是最常見的一種效果同時對于我們Coder來說也應該是最容易實現的,所以自己抽空寫一下。如果發現有什么錯漏的地方,麻煩指出,同時我也會不斷自我完善。
gayhub地址:SimpleBanner