首页 > 代码库 > CycleRotationView:自定义控件之轮播图

CycleRotationView:自定义控件之轮播图

CycleRotationView:自定义控件,主要功能是实现类似与各种商城首页的广告轮播图。其实像这种比较常见的自定义控件早就满大街了,虽然说“不要重复发明轮子”,但是不代表不用关心轮子是怎么造的,本着“知其然知其所以然”的态度,完成了这个控件(总不能需要用到时才来学习吧)。老规矩,先来个效果图(没有效果图的文章都是耍流氓):

技术分享

对于轮播图的图片切换,大家立马会想到 ViewPager 这个控件,因为它已经拥有左右滑动的功能,用来实现轮播图效果会简单一些,本篇也是基于 ViewPager 这个控件的实现,将其分成下面四个部分:
1、图片轮播
2、指示器
3、图片指示器联动
4、定时轮播
下面开始实现(有点啰嗦,勿喷…):

图片轮播

布局文件

<RelativeLayout
       android:layout_width="match_parent"
       android:layout_height="120dp">
       <android.support.v4.view.ViewPager
           android:id="@+id/viewPager"
           android:layout_width="match_parent"
           android:layout_height="120dp" />
       <LinearLayout
           android:layout_width="match_parent"
           android:layout_height="18dp"
           android:layout_alignParentBottom="true"
           android:background="#66000000"
           android:orientation="horizontal">
           <TextView
               android:id="@+id/title"
               android:layout_width="0dp"
               android:layout_height="wrap_content"
               android:layout_marginLeft="15dp"
               android:layout_weight="1"
               android:textColor="#FFFFFF" />
           <LinearLayout
               android:id="@+id/pointGroup"
               android:layout_width="wrap_content"
               android:layout_height="wrap_content"
               android:layout_gravity="center"
               android:layout_marginRight="15dp"
               android:orientation="horizontal" />
       </LinearLayout>
   </RelativeLayout>

先来看看布局文件,最外层的 RelativeLayout 代表整个控件,包含 ViewPager 和一个 LinearLayout;在 LinearLayout 中又包含 TextView 和 LinearLayout。这里说明一下:第一个 LinearLayout 包含标题(id=title)和指示器(id=pointGroup),第二个 LinearLayout 用来包裹指示器(在代码里完成),给张理解图(这里我并没有设置标题):

技术分享

代码实现

    /**
     * 初始化布局
     * @param mContext
     */
    private void initView(Context mContext) {
        View view = LayoutInflater.from(mContext)
                .inflate(R.layout.cycle_rotation_layout, this, true);
        mViewPager = (ViewPager) view.findViewById(R.id.viewPager);
        mPointGroup = (LinearLayout)view.findViewById(R.id.pointGroup);
    }

首先是加载刚才的布局文件,把 ViewPager 和 pointGroup 找出来;

    for (int i = 0; i < images.length; i++) {
        // 创建 ImageView,并设置图片
        ImageView img = new ImageView(mContext);
        // 把图片扩大到 ImageView 的大小
        img.setScaleType(ImageView.ScaleType.FIT_XY);
        img.setImageResource(images[i]);
        mList.add(img);
        }

根据用户传递过来的图片的数量进行遍历创建对应数量的 ImageView ,然后给创建的 ImageView 设置图片,再用一个 List 集合把 ImageView 装起来待用。在 Fragement + ViewPager + TabLayout 的场景里 ViewPager 里填充的是 Fragement,而这里的 ViewPager 填充的是 ImageView;

    /**
    * 适配器
    */
    class CycleAdapter extends PagerAdapter {

        @Override
        public int getCount() {
            return Integer.MAX_VALUE;
        }

        @Override
        public Object instantiateItem(ViewGroup container, int position) {
            position = position % mList.size();
            // 判断该 item 是否已经有 parent
            final View child = mList.get(position);
            if (child.getParent() != null) {
                container.removeView(child);
            }
            container.addView(mList.get(position));
            return mList.get(position);
        }

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

        @Override
        public boolean isViewFromObject(View view, Object object) {
            return view == object;
        }
    }

适配器上场了,在 getCount() 方法里返回 Integer.MAX_VALUE 是因为 ViewPager 不会循环滑动,给这么一个数值(据说 Integer.MAX_VALUE 的值是 10亿,我没试过)可以让它一直滑下去。问题来了:这么大的数值,会不会出现性能问题?这个我也好奇,看谁更有兴趣咯。
还要说一下 instantiateItem() 方法,为什么要判断 parent 的状态?原因是如果不这样处理,在向左滑动 ViewPager 的时候会报错: The specified child already has a parent. You must call removeView
注意:instantiateItem() 进行了判断,destroyItem() 就不用再 removeView() 了,否则会出现空白页。

指示器

    /**
    * 创建指示器
    */
    for(int i = 0; i < images.length; i ++) {
        // 创建指示器,实质也是 ImageView
        ImageView point = new ImageView(mContext);
        point.setImageResource(R.drawable.shape_point_selector);
        // 指示器布局参数
        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(pointSize, pointSize);
        // 第2个起才设置左边距
        if (i > 0) {
            params.leftMargin = pointMargin;
            point.setSelected(false); // 默认选中第1个
        } else {
            point.setSelected(true); // 默认选中第1个
        }
        point.setLayoutParams(params); // 给指示器设置参数
        mPointGroup.addView(point); // 把指示器添加到容器
    }

创建指示器的时候为了和 ImageView 的数量对应,所以同样要遍历用户设置的图片数量。下面是指示器的相关布局文件:
shape_point_selector:

<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_selected="true" android:drawable="@drawable/shape_point_selected" />
    <item android:state_selected="false" android:drawable="@drawable/shape_point_normal" />
</selector>

shape_point_selected:

<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="oval">
    <solid android:color="#FFFFFF"/>
</shape>

shape_point_normal:

<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="oval">
    <solid android:color="#66000000"/>
</shape>

ViewPager 和 pointGroup 都创建好了,接下来是他们俩的联动:

联动

 mViewPager.setAdapter(new CycleAdapter());

        // ViewPager 的监听事件
        mViewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
            @Override
            public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {}

            int lastPosition;
            @Override
            public void onPageSelected(int position) {
                position = position % mList.size();
                // 设置当前圆点选中
                mPointGroup.getChildAt(position).setSelected(true);
                // 设置前一个圆点不选中
                mPointGroup.getChildAt(lastPosition).setSelected(false);
                lastPosition = position;
            }

            @Override
            public void onPageScrollStateChanged(int state) {}
        });

 

给 ViewPager 添加监听事件,在选中某个页面的同时设置相应位置指示器也被选中。position % mList.size():Adapter 的 getCount() 中返回了很大的值,这里求余可以保证不会出现空指针异常。

定时轮播

 mHandler.postDelayed(new Runnable() {
            @Override
            public void run() {
                // 当前选中的 item
                int currentItem = mViewPager.getCurrentItem();
                // 判断是否是最后一个 item
                if (currentItem == mViewPager.getAdapter().getCount() - 1) {
                    mViewPager.setCurrentItem(1);
                } else {
                    mViewPager.setCurrentItem(currentItem + 1);
                }
                // 不断给自己发消息
                mHandler.postDelayed(this, 3000);
            }
        }, 3000);

 

定时轮播也很简单,用 Handler 来延时给自己发消息。在 ViewPager 滑动到最后一个时给它设置 mViewPager.setCurrentItem(1) 来实现循环轮播。
基本的轮播功能到这里就完成了,但是还有很多的拓展功能,比如点击事件,用户设置图片链接,这些我都已经实现了,这里就不一一介绍了,有兴趣的可以看看源码:cycleRotation

CycleRotationView:自定义控件之轮播图