RollViewPager的使用

RollViewPager是一个实现图片轮播的安卓开源库。对它的使用只需5步。

1.添加依赖

implementation ‘com.jude:rollviewpager:1.4.6’

2.在xml布局文件中添加view

 	    <!--hint（indicator）圆点位置：app:rollviewpager_hint_gravity="left"-->
        <!--圆点距离本空间的左边：app:rollviewpager_hint_paddingLeft="70dp"(或者paddingbottom)-->
        <!--圆点所在的容器（本控件的下部分）的透明度：app:rollviewpager_hint_alpha="255"-->
        <!--圆点所在的容器（本控件的下部分）的颜色(必须先设置透明度)：app:rollviewpager_hint_color="#a000ff00"-->
        <com.jude.rollviewpager.RollPagerView
            android:id="@+id/roll_view_pager"
            android:layout_width="match_parent"
            android:layout_height="180dp"
            app:rollviewpager_hint_color="#aa00ff00"
            app:rollviewpager_play_delay="2500" />

3.在activity中添加适配器内部类

(如果该适配器需要在不同的activity中用到，可以在模块根目录下新建一个adapter目录存放本类，class的权限修饰符改为public)

    private class RollPagerAdapter extends StaticPagerAdapter {
        private int[] datas_list = {
                R.drawable.img1,
                R.drawable.img2,
                R.drawable.img3,
                R.drawable.img4,
        };

        @Override
        public View getView(ViewGroup container, int position) {
        //  当然也可以通过LayoutInflator加载xml布局文件，再返回该view，该view是轮播内容的view（不包括圆点区域）
            ImageView view = new ImageView(container.getContext());
            view.setImageResource(datas_list[position]);
            view.setScaleType(ImageView.ScaleType.CENTER_CROP);
            view.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
            return view;
        }

        @Override
        public int getCount() {
            return datas_list.length;
        }
    }

4.在activity的onCreate()中使用

        RollPagerView mRollViewPager = findViewById(R.id.roll_view_pager);
//		设置轮播间隔
//        mRollViewPager.setPlayDelay(1000);
//		设置轮播动画时间
        mRollViewPager.setAnimationDurtion(1500);
        mRollViewPager.setAdapter(new RollPagerAdapter());

//        设置圆点颜色
        mRollViewPager.setHintView(new ColorPointHintView(this, ResourcesCompat.getColor(getResources(), R.color.yellow, null), Color.WHITE));
//      图片取代圆点
//        mRollViewPager.setHintView(new IconHintView(this,R.drawable.point_focus,R.drawable.point_normal));
//        文字取代圆点，如2/3就是播放到第二张图
//        mRollViewPager.setHintView(new TextHintView(this));
//        取消圆点区域
//        mRollViewPager.setHintView(null);
//        暂停轮播
//        mRollViewPager.pause();
//        是否正在轮播，返回boolean
//        mRollViewPager.isPlaying();
//        重新开始轮播
//        mRollViewPager.resume();

5.在drawable目录下放置你要轮播的图片

R.drawable.img1
R.drawable.img2
R.drawable.img3
R.drawable.img4

功能增强

功能增强1.实现无限轮播，不会突兀地从最后一张回到第一张

（1）首先创建另外一个适配器类LoopRollPagerAdapter 来取代上面的RollPagerAdapter,代码在下面
（2）将
mRollViewPager.setAdapter(new RollPagerAdapter())；
改为
mRollViewPager.setAdapter(new LoopRollPagerAdapter(mRollViewPager)）;

 private class LoopRollPagerAdapter extends LoopPagerAdapter {
        private int[] datas_list = {
                R.drawable.img1,
                R.drawable.img2,
                R.drawable.img3,
                R.drawable.img4,
        };

        public LoopRollPagerAdapter(RollPagerView viewPager) {
            super(viewPager);
        }

        @Override
        public View getView(ViewGroup container, int position) {
            ImageView view = new ImageView(container.getContext());
            view.setImageResource(datas_list[position]);
            view.setScaleType(ImageView.ScaleType.FIT_XY);
            view.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
            return view;
        }

        @Override
        public int getRealCount() {
            return datas_list.length;
        }
  }

功能增强2.实现点击轮播图事件处理

在activity的onCreate中添加以下代码

 mRollViewPager.setOnItemClickListener(new OnItemClickListener() {
            @Override
            public void onItemClick(int position) {
                Toast.makeText(getApplicationContext(),"你点击了位置为"+position+"的轮播图",Toast.LENGTH_SHORT).show();
            }
        });

---

最后，说一下viewpager中的MVC
MVC:
M：Model 数据
V：View 视图
C：Controller 控制者
其中Controller起着中间人的作用，负责将model数据加载到view视图中

---

在本例中，RollViewPager是View，RollPagerAdapter 是Controller，而Model数据则来源于Adapter中的datas_list。ViewPager（RollViewPager是一种特殊的ViewPager）是通过
mRollViewPager.setAdapter(new RollPagerAdapter());
这行代码与Adapter关联起来的。这行代码指定了由那个Adapter向ViewPager提供数据。关联之后，当ViewPager需要数据时，就会回调其关联的Adapter对象中的getView方法得到View对象数据。所以，Adapter对象要向其负责的ViewPager提供数据，那么就必须持有数据。数据的来源可以在Adapter对象初始化时的构造函数中将数据从外部环境例如Activity中赋值给它，例如在本例中，将datas_list移到activity中作为成员变量，再通过
mRollViewPager.setAdapter(new RollPagerAdapter(datas_list));
传递给Adapter对象。（当然，在编写RollPagerAdapter类时需要提供对应的构造器。）这样做的好处是将Model数据和Controller（本例中的Adapter适配器）解耦。如果不同的activity想调用该RollPagerAdapter的功能，但又想轮播不同的图片数据，可以在不同的activity中提供不同的datas_list，再通过构造器传递给需要构造的RollPagerAdapter对象。这时解耦的概念就发挥了作用。

github源码地址：
https://github.com/Jude95/RollViewPager