banner框架,一个比较齐全的框架

来源:互联网 发布:游戏编程培训学校 编辑:程序博客网 时间:2024/06/05 14:27

首先奉献上作者的github地址 https://github.com/youth5201314/banner  这是一个star数过千,fork数过百的轮子,用起来也是good的,不过使用的时候不注意也是能遇到坑的,这里的话效果图就不贴了,需要看的话可以直接去GitHub 上直接看

怎么去读这个框架呢,它不是一个项目,所以不能从启动的activity开始读起,但它是一个自定义的view,所以我们可以从自定义的view开始读起来 也就是我们的布局引用的com.youth.banner下的Banner类 

 Banner类的拆包

     构造方法

  首先我们看到的是banner继承自FrameLayout类,所以我们当然想到的是三大构造方法了,想到了,那当然去看了



直接看三个参数的构造方法了,前面都是一些常规的初始化操作,直接看initView(context,attrs)方法了,

        a.initView(context,attrs)方法


加载banner的布局文件(下一个小节会看下),然后初始化控件,这个都是没得说的, 接下来handleTypedArray(context,attrs)初始化自定义的属性,最后的initViewPagerScroll()初始化viewpager的滚动时间的这里面应用了两个自定义的控件BannerScroller 和BannerViewpager
            1.这里来简单看下布局文件 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:id="@+id/bannerContainer"    android:layout_width="match_parent"    android:layout_height="match_parent"    android:clipChildren="false">    <com.youth.banner.view.BannerViewPager        android:id="@+id/bannerViewPager"        android:layout_width="match_parent"        android:layout_height="match_parent"        android:clipChildren="false" />    <RelativeLayout        android:layout_width="match_parent"        android:layout_height="wrap_content"        android:layout_alignParentBottom="true">        <LinearLayout            android:id="@+id/circleIndicator"            android:layout_width="match_parent"            android:layout_height="wrap_content"            android:layout_gravity="bottom"            android:gravity="center"            android:orientation="horizontal"            android:padding="10dp"            android:visibility="visible" />        <TextView            android:id="@+id/numIndicator"            android:layout_width="40dp"            android:layout_height="40dp"            android:layout_alignParentRight="true"            android:layout_margin="8dp"            android:background="@drawable/black_background"            android:gravity="center"            android:text="1/1"            android:textColor="#ffffff"            android:visibility="visible" />        <LinearLayout            android:id="@+id/titleView"            android:layout_width="match_parent"            android:layout_height="40dp"            android:layout_below="@+id/circleIndicator"            android:background="#44000000"            android:orientation="horizontal"            android:visibility="visible">            <TextView                android:id="@+id/bannerTitle"                android:layout_width="match_parent"                android:layout_height="match_parent"                android:layout_weight="1000"                android:ellipsize="marquee"                android:focusable="true"                android:focusableInTouchMode="true"                android:gravity="center_vertical"                android:paddingLeft="10dp"                android:singleLine="true"                android:textColor="#ffffff"                android:visibility="gone" />            <FrameLayout                android:layout_width="wrap_content"                android:layout_height="match_parent"                android:paddingLeft="10dp"                android:paddingRight="10dp">                <TextView                    android:id="@+id/numIndicatorInside"                    android:layout_width="wrap_content"                    android:layout_height="match_parent"                    android:gravity="center_vertical"                    android:text="1/1"                    android:textColor="#ffffff"                    android:visibility="gone" />                <LinearLayout                    android:id="@+id/indicatorInside"                    android:layout_width="wrap_content"                    android:layout_height="match_parent"                    android:gravity="center_vertical"                    android:orientation="horizontal"                    android:visibility="gone" />            </FrameLayout>        </LinearLayout>    </RelativeLayout></RelativeLayout>

            这里用的是一个相对布局包裹了一个自定义的viewpager和一系列的指示器,还是很简单的了。
             2. BannerScroller类
            bannerScroller继承自scroller,重写了其中的startScroll这个方法,增加一个setDuration(int time)  从而使得两个banner之间切换的持续时间可控
              3.BannerViewpager类
            bannerViewpager类继承自viewPager,增加了一个属性scrollable,重写了事件监听ontouchEvent()和事件拦截onInterceptTouchEvent  从而控制了是否让用户手滑动banner ,默认的话是true

这个时候感觉不知道从哪看了,我们可以看下banner的初始化,省去一些set的基本操作,我们会看到调用了start(),ok,那我们从这边开始看

start()方法

   里面很简单就下面的三个方法
setBannerStyleUI();
setImageList(imageUrls);
setData();
   我们一个个来看

   a.setBannerStyleUI() 文字指示器的初始化

    
这个主要是对banner的文字描述进行初始化,   首先做的是一些异常情况,比如你的文字描述的条数和banner图片的url不一样那么不开玩笑了么,作者为了防止这种情况抛了个异常,后面的话就是一些初始化的操作了

b.setImageList(imageUrls)  小圆点指示器的初始化

    
    根据imagesUrl的size()通过initImages()--  createIndicator()方法去 动态创建类似小圆点指示器 
        这里我们还要⚠️的是一个方法 imageLoader.displayImage(context,url,imageView);看名字我们知道这是一个通过url加载图片的方法,这个imageLoader来自
public interface ImageLoaderInterface<T extends View> extends Serializable {    void displayImage(Context context, Object path, T imageView);    T createImageView(Context context);}

   是需要你写个类去实现这个ImageLoaderInterface接口并且在start()方法之前实例话setImageLoader()进去的   

c:setData()

    
        这个方法就是对viewpager的一些初始化操作了,比如adapte,滑动点击事件 (addOnpageChangeListtener(this),这里重要重写onPageChangeListener事件的三个方法),以及只有一个轮播图片的时候,设置不能滑动,如果想一张能滑动的话就要修改这边了,最后的是自动轮播的
    

监听事件的操作方法

   a onPageChangeListener事件  

@Overridepublic void onPageScrollStateChanged(int state) {    if (mOnPageChangeListener != null) {        mOnPageChangeListener.onPageScrollStateChanged(state);    }    currentItem = viewPager.getCurrentItem();    switch (state) {        case 0://No operation            if (currentItem == 0) {                viewPager.setCurrentItem(count, false);            } else if (currentItem == count + 1) {                viewPager.setCurrentItem(1, false);            }            break;        case 1://start Sliding            if (currentItem == count + 1) {                viewPager.setCurrentItem(1, false);            } else if (currentItem == 0) {                viewPager.setCurrentItem(count, false);            }            break;        case 2://end Sliding            break;    }}@Overridepublic void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {    if (mOnPageChangeListener != null) {        mOnPageChangeListener.onPageScrolled(position, positionOffset, positionOffsetPixels);    }}@Overridepublic void onPageSelected(int position) {    if (mOnPageChangeListener != null) {        mOnPageChangeListener.onPageSelected(position);    }    if (bannerStyle == BannerConfig.CIRCLE_INDICATOR ||            bannerStyle == BannerConfig.CIRCLE_INDICATOR_TITLE ||            bannerStyle == BannerConfig.CIRCLE_INDICATOR_TITLE_INSIDE) {        indicatorImages.get((lastPosition - 1 + count) % count).setImageResource(mIndicatorUnselectedResId);        indicatorImages.get((position - 1 + count) % count).setImageResource(mIndicatorSelectedResId);        lastPosition = position;    }    if (position == 0) position = count;    if (position > count) position = 1;    switch (bannerStyle) {        case BannerConfig.CIRCLE_INDICATOR:            break;        case BannerConfig.NUM_INDICATOR:            numIndicator.setText(position + "/" + count);            break;        case BannerConfig.NUM_INDICATOR_TITLE:            numIndicatorInside.setText(position + "/" + count);            bannerTitle.setText(titles.get(position - 1));            break;        case BannerConfig.CIRCLE_INDICATOR_TITLE:            bannerTitle.setText(titles.get(position - 1));            break;        case BannerConfig.CIRCLE_INDICATOR_TITLE_INSIDE:            bannerTitle.setText(titles.get(position - 1));            break;    }}

    这个里面设置了图片的轮播形势,指示器的改变

  b 点击的dispatchTouchEvent()事件

@Override    public boolean dispatchTouchEvent(MotionEvent ev) {//        Log.i(tag, ev.getAction() + "--" + isAutoPlay);        if (isAutoPlay) {            int action = ev.getAction();            if (action == MotionEvent.ACTION_UP || action == MotionEvent.ACTION_CANCEL                    || action == MotionEvent.ACTION_OUTSIDE) {                startAutoPlay();            } else if (action == MotionEvent.ACTION_DOWN) {                stopAutoPlay();            }        }        return super.dispatchTouchEvent(ev);    }


    手指放到banner上的时候停止自动轮播,抬起或者取消,或者移到控件外面的时候重新开始自动轮播

c.设置banner图片的点击事件

    通过BannerPagerAdapter这个

来进行回掉设置的。

ok,剩下的就是一些方法都是增加对外的接口,设置默认的一些属性的,基本也就是这样了,是不是很简单的呢,其实真正的实现没有说的这么简单。
0 0
原创粉丝点击