Blog.kt

手动实现轮播图（二）：循环滚动、定时切换与指示器

2018-04-21

前言

在上一篇文章手动实现轮播图（一）：ViewPager 入门实践中，我们认识了ViewPager这个布局，也简单上手了一下。

接下来这篇文章，我们会进一步朝着轮播图的方向前进。

原来的文章末尾，我使用了 Glide 加载 Gif 图片作为轮播图的内容，所以现在也是基于那个代码继续下去的。

如果对这部分比较陌生，建议回去看一下文章末尾仓库地址里的代码哦

本文章中我们将会实现：

  • 循环滚动
  • 切换指示器
  • 定时切换

接下来就让我们开工吧。

1. 循环滚动

ViewPager虽然好用，但是并不原生支持循环滚动，也就是你：

  • 第一个往左滑，会跳到最后一个
  • 从最后一个往右滑，会调回第一个

我们之前实现的效果里，第一个就无法再往左滑了，最后一个就无法再往右滑了。这样轮播图就不是“轮”播了。

所以我们需要自己来实现循环滚动这个效果。

该怎么实现呢？目前也有比较成熟的三个做法：

多页面假循环

  • 创建很多个页面，即便我们真正需要展示的时候只有 5 个页面
    • 把起始点放在队列中间，如果到了要展示的第一个页面，继续往左的时候，我们把接下来就把页面设置为最后一个的样式
    • 这样不管用户往左还是往右滑，只要是正常情况下，用户都是滑不到头的，造成视觉上的循环
      • 正常 App 中，即便你使用一个这样的页面队列来显示，用户也没有耐心一直滑下去

假设我们现在创建了 1000 个页面的ViewPager，然后我们实际需要展示的只有 5 个页面，那么实现的效果如下：

我们把第一个展示的页面设置为 500，那用户需要滑动 499 才会到头。

pic

这样性能会不会很差？

  • 不会

因为虽然说的是“创建1000”个页面，但是实际上我们只是告诉ViewPager的Adapter我们会使用这么多个，不代表他会创建这么多个。

我们会在Adapter的getCount方法里返回 1000，这个方法只是帮助Adapter获取正确的position的，并不是真正创建出来。（通过阅读PagerAdapter 的源码得出）

记得前面我们说过的，FragmentPagerAdapter会默认帮我们创建三个页面，所以这里也只会创建三个页面，超过前中后的其他页面都会被回收。

其余两种实现方法

我们主要使用第一种，理解起来简单易懂，也没有明显的短板。

其余两种方法描述看下面这篇文章：Android实现真正的ViewPager【平滑过渡】…

介绍完实现思路，我们就可以开始实现了。

打开MainActivity.java，修改代码如下：

public class MainActivity extends AppCompatActivity {
    private static final int MAX_NUMBER = 1000;
    private static final int START_POSITION = MAX_NUMBER/2;
    ...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        ...
        mViewPager.setAdapter(new FragmentPagerAdapter(fm) {

            // 存储通过 position 计算出正确的数组索引
            private int mIndex;

            @Override
            public Fragment getItem(int position) {
                mIndex = Math.abs(position - START_POSITION) % mStringList.length;

                if (position < START_POSITION && mIndex != 0){
                    mIndex = mStringList.length - mIndex;
                }

                return PageFragment.newInstance(mIndex);
            }

            @Override
            public int getCount() {
                return MAX_NUMBER;
            }


        });

        mViewPager.setCurrentItem(START_POSITION);

        ...
    }
}
  • 定义两个常量，分别是
    • MAX_NUMBER：页面总数，一共 1000 个
    • START_POSITION：起始的页面，从中间第 500 个开始
mIndex = Math.abs(position - START_POSITION) % mStringList.length;

if (position < START_POSITION && mIndex != 0){
    mIndex = mStringList.length - mIndex;
}
  • 计算当前位置position和起始位置（START_POSITION）的距离，然后把结果和真正要展示的页面数量（此处暂时使用mStringList的长度代替）取余
    • 距离有正负，所以取了绝对值。但是如果只是绝对值然后去取余的话，左滑的时候，就不是 1->5 -> 4 这样子，而是 1 ->2 ->3 这样。这是取余运算的结果，不熟悉的同学可以回忆一下取余的结果
    • 所以我们加了判断
      • 页面position大于起始位置 ，那就直接用相对距离取余
      • 如若小于起始位置，那么用实际页面数量减去取余结果，就可以实现倒数的效果了
@Override
public int getCount() {
    return MAX_NUMBER;
}
  • 此处告诉Adapter一共有多少个页面

记得设置起始页面哦：

mViewPager.setCurrentItem(START_POSITION);

这样我们的循环滚动就完成了~快试试看吧。

pic

2. 页面指示器

许多轮播图都有一个小指示器，用来标志当前的页面。我们现在就来做一个。

做了前面的循环滚动，这样的页面指示器原理应该不难理解。

思路是：

  • 创建控件样式
    • 选中的样式
    • 未选中的样式
  • 添加控件到视图里面
  • 当页面滑动的时候，修改指示器的样式

创建控件样式

在res/drawable文件夹里，创建两个文件：

正常样式：dot_normal.xml

<?xml version="1.0" encoding="utf-8" ?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="oval">
    <size android:width="5dp"
        android:height="5dp"/>
    <solid android:color="@android:color/holo_red_dark"/>
</shape>

被选中样式：dot_selected.xml

<?xml version="1.0" encoding="utf-8" ?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="oval">
    <size android:width="5dp"
        android:height="5dp"/>
    <solid android:color="@color/colorPrimary"/>
</shape>

接着在activity_main.xml里加入一个LinearLayout布局，后面我们使用代码的方式把小点加入进去：

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <android.support.v4.view.ViewPager
        android:id="@+id/view_pager_inside"
        android:layout_width="400dp"
        android:layout_height="400dp"
        android:background="@android:color/darker_gray"
        android:layout_centerInParent="true">
    </android.support.v4.view.ViewPager>

    <LinearLayout
        android:id="@+id/ll_inside"
        android:layout_below="@+id/view_pager_inside"
        android:layout_width="match_parent"
        android:layout_height="30dp"
        android:orientation="horizontal"
        android:gravity="center"/>

</RelativeLayout>

添加控件到视图中

此处的代码思路来自Android ViewPager 无限循环左右滑动（可自动） 实现。

回到MainActivity.java中，

public class MainActivity extends AppCompatActivity {
    private List<TextView> mTextViews;
    private LinearLayout mLinearLayout;

    ...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mViewPager = findViewById(R.id.view_pager_inside);
        mLinearLayout = findViewById(R.id.ll_inside);

        initCircle();
        ....
    }

    ...
    private void initCircle() {
        mTextViews = new ArrayList<>();
        int d = 20;
        int m = 7;

        for (int i = 0; i < mStringList.length; i++){
            TextView textView = new TextView(this);
            if (i == 0){
                textView.setBackgroundResource(R.drawable.dot_selected);
            }else {
                textView.setBackgroundResource(R.drawable.dot_normal);
            }

            LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(d, d);

            params.setMargins(m, m, m, m);
            textView.setLayoutParams(params);
            mTextViews.add(textView);
            mLinearLayout.addView(textView);
        }
    }
    ...
}
  • 定义两个变量
    • mTextViews：存放小点的列表
      • 我们的小点其实是由TetxView构成，然后背景颜色设置为圆形的
    • mLinearLayout：引用刚刚创建的LinearLayout布局
  • 创建一个initCIrcle()方法
    • 使用代码的方式创建TextView视图，为每个视图设置宽高、外边距和背景等属性
      • 背景样式就是刚刚创建的两个.xml文件
    • 使用 addView方法把小点添加到布局当中

在Oncreate()方法中调用之后，我们就会看到小点已经出现了。

现在我们需要根据页面来修改样式，以达到指示器的作用。

public class MainActivity extends AppCompatActivity {

    ...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        ...
        mViewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
            @Override
            public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {

            }

            @Override
            public void onPageSelected(int position) {
                changePoints(position % mStringList.length);
            }

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

    private void changePoints(int pos){
        if (mTextViews != null){
            for (int i = 0; i < mTextViews.size(); i++){
                if (pos == i){
                    mTextViews.get(i).setBackgroundResource(R.drawable.dot_selected);
                }else {
                    mTextViews.get(i).setBackgroundResource(R.drawable.dot_normal);
                }
            }
        }
    }
}
  • 为mViewPager添加一个状态监听器ViewPager.OnPageChangeListener
    • 重写onPageSelected()方法：该方法会在页面被选中的时候调用
    • 在该方法内，我们调用changePoint()方法来改变指示器的样式

我们在调用changePoint()的时候，传入的是position % mStringList.length。这里是有问题的。

如果直接使用position对mString.length进行取模，在这个例子里是没问题，因为我们起始位置（500）恰好是mString.length的倍数。所以此时会从 0 开始。但如果我们以后修改了起始位置亦或者修改了展示图片的数量的话，这里就会出错了。

所以我们还是使用和之前一样的方式来获得索引值。修改一下onPageSelected()方法：

private int mIndex;

@Override
public void onPageSelected(int position) {
    mIndex = Math.abs(position - START_POSITION) % mStringList.length;
    if (position < START_POSITION && mIndex != 0){
        mIndex = mStringList.length - mIndex;
     }
    changePoints(mIndex);

}

这里为了方便，就直接使用这段代码了。有时间的同学可以自己优化一下，提高复用率。

按照道理，现在应该就可以了。

indicator

3. 定时播放

轮播图的其中一个特点，就是定时播放。

我们已经实现了这么多效果了，定时播放应该也是小菜一碟。

我们可以使用Handle调用setCurrentItem()即可。

以下代码思路来自Android ViewPager 无限循环左右滑动（可自动） 实现。

修改我们的MainActivity.java

private Handler mHandler = new Handler();

protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ...
        mHandler = new Handler();
        mHandler.postDelayed(new TimerRunnable(),5000);
    }

    class TimerRunnable implements Runnable{

        @Override
        public void run() {
            int curItem = mViewPager.getCurrentItem();
            mViewPager.setCurrentItem(curItem+1);
            if (mHandler!=null){
                mHandler.postDelayed(this,5000);
            }
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mHandler = null; //此处在Activity退出时及时 回收
}

4. 修改过渡动画

调用ViewPager.setPageTransformer()方法即可自行设置动画。

让我们先新建一个动画类PhotoTransformer.java

package me.rosuh.android.viewpagernew;

import android.support.annotation.NonNull;
import android.support.v4.view.ViewPager;
import android.view.View;


public class PhotoTransformer implements ViewPager.PageTransformer {
    @Override
    public void transformPage(@NonNull View page, float position) {
        int pageWidth = page.getWidth();

        if (position < -1){
            page.setAlpha(1);
        }else if (position <= 1){
            page.setPivotX(position < 0f ? page.getWidth() : 0f);
            page.setPivotY(page.getHeight() * 0.5f);
            page.setRotationY(90f * position);

        }else {
            page.setAlpha(1);
        }
    }
}

然后为mViewPager设置动画：

...
FragmentManager fm = getSupportFragmentManager();

mViewPager.setPageTransformer(true, new PhotoTransformer());

mViewPager.setAdapter(...)

设置这个动画，最好把CardView的阴影属性设置为 0。 然后稍微修改一下布局。（在此不列出，可以到代码仓库自己看一下）。 下面是效果：

transformer

结语

本项目地址ViewPagerDemo。

目前为止，我们的轮播图就已经做好了。

这两篇文章的目标读者是刚入门的同学，所以有许多地方还有改进的空间。

但是不碍于我们掌握。

文章作者毕竟经验不多，水平有限，所以缺漏在所难免，希望路过读到本文的前辈们不吝赐教，谢谢~

感谢一下参考文章和资料：

cat

Profile picture

rosu

An Android Developer.

GitHub Twitter icon