Android RecyclerView的使用解析（一）

2016-10-19 本文已影响912人 mkdir_mushroom

前言

RecyclerView是Android5.0带来的一个旨在替代ListView的新控件，收录在android.support.v7.widget包下。转眼之间，它已经面世2年了，大家也或多或少了解或运用过这个吊吊的控件，下面就由我带领您走向RecyclerView的世界。

初识RecyclerView

我们先来看看这个控件的名字，所谓RecyclerView，意思就是老子只负责回收复用View，其它的事不管。看它趾高气扬的样子，你是不是想弄死它？其实啊，人家确实有装B的资格，相比较ListView而言，我们可以更加灵活地定制控件的效果。
要使用RecyclerView，首先需要了解以下两个相关的类：

LayoutManager

这个类主要用于控制RecyclerView的显示规则的，它是一个抽象类，系统给我们提供了三个默认的实现类，它们是LinearLayoutManager 、 GridLayoutManager和StaggeredGridLayoutManager。
从名字就可以看出，我们可以利用它们分别让RecyclerView显示线性布局，网格布局和瀑布流布局。

RecyclerView.Adapter

同ListView一样，RecyclerView也提供一个适配器来控制每个item的显示内容。我们需要继承RecyclerView.Adapter<VH extends VeiwHolder>，并将泛型中的类名指定为自定义的ViewHolder类名，接着创建一个静态的自定义ViewHolder（RecyclerView帮我们封装好了ViewHolder，我们只需要在它的基础上实现功能即可），然后复写以下三个方法：

onCreateViewHolder
该方法主要为每一个item加载布局，并将布局传递给自定义的ViewHolder。
onBindViewHolder
该方法主要是建立起自定义ViewHolder中视图与数据的关联。
getItemCount
该方法用于对item进行计数。

简单的实现

废话不多说，下面我们来进入实战，首先我们要实现一个ListView显示item项的效果。

在AS中新建一个项目，我们这里就叫做RecyclerViewTest吧，添加以下依赖：

dependencies {
    ...//其它依赖
    compile 'com.android.support:recyclerview-v7:24.2.1'
}

接着在布局文件中创建我们的RecyclerView布局：

<RelativeLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.wuminmiao.recycleviewtest.MainActivity">
    <android.support.v7.widget.RecyclerView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:scrollbars="vertical"/>
</RelativeLayout>

并创建item的布局：

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:background="#add8e6"
    android:layout_height="70dp">
<TextView
    android:id="@+id/text"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"/>

</FrameLayout>

然后在MainActivity的onCreate方法中获取RecyclerView的实例，并且为它设置适配器Adapter和布局管理器LayoutManager。MainActivity的代码如下：

import android.app.Activity;
import android.os.Bundle;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import java.util.ArrayList;
import java.util.List;

public class MainActivity extends Activity {

    private RecyclerView mRecyclerView;
    private RecyclerView.Adapter mAdapter;
    private RecyclerView.LayoutManager mLayoutManager;
    private List<String> mDataset;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate (savedInstanceState);
        setContentView (R.layout.activity_main);
        initViews();
        initData();
        mLayoutManager = new LinearLayoutManager (this,
                LinearLayoutManager.VERTICAL, false);//这里我们使用默认的线性布局管理器,将其设为垂直显示
        mRecyclerView.setLayoutManager (mLayoutManager);//设置布局管理器
        mAdapter = new TestAdapter(this, mDataset);//实例化适配器
        mRecyclerView.setAdapter (mAdapter);//设置适配器
    }

    private void initViews() {
        mRecyclerView = (RecyclerView) findViewById (R.id.test_recycle_view);
    }

    private void initData() {
        mDataset = new ArrayList<String> ();
        for ( int i = 0; i <= 50; i++) {
            mDataset.add( "item"+i);
        }
    }
}

接着我们就要创建自定义Adapter了：

import android.content.Context;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
import java.util.List;

/**
 * Created by wuminmiao on 2016/10/13.
 */

public class TestAdapter extends RecyclerView.Adapter<TestAdapter.MyViewHolder> {

    private Context mContext;
    private List<String> mDataset;
    private LayoutInflater mInflater;


    //提供一个合适的构造方法
    public TestAdapter(Context context, List<String> dataset) {
        this.mContext = context;
        this.mDataset = dataset;
        mInflater = LayoutInflater.from (context);
    }

    /**
     *将布局转换为View并传递给自定义的MyViewHolder
     * @param viewGroup
     * @param viewType
     * @return
     */
    @Override
    public MyViewHolder onCreateViewHolder(ViewGroup viewGroup, int viewType) {
        View view = mInflater.inflate (R.layout.item, viewGroup, false);
        MyViewHolder viewHolder = new MyViewHolder (view);
        return viewHolder;
    }

    /**
     * 建立起MyViewHolder中视图与数据的关联
     * @param viewHolder
     * @param position
     */
    @Override
    public void onBindViewHolder(MyViewHolder viewHolder, int position) {
        viewHolder.mTextView.setText(mDataset.get (position));
    }

    /**
     * 获取item的数目
     * @return
     */
    @Override
    public int getItemCount() {
     return mDataset.size ();
    }

    //自定义的ViewHoder，持有item的所有控件
    public static class MyViewHolder extends RecyclerView.ViewHolder {
         TextView mTextView;
        public MyViewHolder(View view) {
            super (view);
            mTextView = (TextView) view.findViewById(R.id.text);
        }
    }
}

现在，我们这个例子就可以正常运行了，效果如下：

RecyclerView4ListView

恩？好像哪里不对！分割线哪里去了？以前用ListView时，我们还可以通过divider属性来设置分割线，但到了RecyclerView这却不行了。这位大爷除了回收复用外啥事都不管，什么设置分割线啊，给item设置动画效果啊等等它丫的统统抛在脑后！那是不是就没辙了？肯定不是啦，前面我们就说过，我们可以自由地定制RecyclerView，那分割线这点芝麻大的事肯定也不在话下啦。

系统给我们提供了一个叫做ItemDecoration的抽象类，却并没有提供它的实现类供我们使用，所以我们必须通过自定义它去使用它，这里我就不重复造轮子啦，网上有很多现成的ItemDecoration的实现类，我们挑一个比较好用的来实现分割线效果:
在我们的项目中添加DividerItemDecoration，该类的代码如下：

import android.content.Context;
import android.content.res.TypedArray;
import android.graphics.Canvas;
import android.graphics.Rect;
import android.graphics.drawable.Drawable;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import android.view.View;

public class DividerItemDecoration extends RecyclerView.ItemDecoration {

    private static final int[] ATTRS = new int[]{
            android.R.attr.listDivider
    };

    public static final int HORIZONTAL_LIST = LinearLayoutManager.HORIZONTAL;

    public static final int VERTICAL_LIST = LinearLayoutManager.VERTICAL;

    private Drawable mDivider;

    private int mOrientation;
    
    public DividerItemDecoration(Context context, int orientation) {
        final TypedArray a = context.obtainStyledAttributes(ATTRS);
        mDivider = a.getDrawable(0);
        a.recycle();
        setOrientation(orientation);
    }

    public void setOrientation(int orientation) {
        if (orientation != HORIZONTAL_LIST && orientation != VERTICAL_LIST) {
            throw new IllegalArgumentException("invalid orientation");
        }
        mOrientation = orientation;
    }

    @Override
    public void onDraw(Canvas c, RecyclerView parent) {
        if (mOrientation == VERTICAL_LIST) {
            drawVertical(c, parent);
        } else {
            drawHorizontal(c, parent);
        }
    }

    public void drawVertical(Canvas c, RecyclerView parent) {
        final int left = parent.getPaddingLeft();
        final int right = parent.getWidth() - parent.getPaddingRight();

        final int childCount = parent.getChildCount();
        for (int i = 0; i < childCount; i++) {
            final View child = parent.getChildAt(i);
            final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child
                    .getLayoutParams();
            final int top = child.getBottom() + params.bottomMargin;
            final int bottom = top + mDivider.getIntrinsicHeight();
            mDivider.setBounds(left, top, right, bottom);
            mDivider.draw(c);
        }
    }
   
    public void drawHorizontal(Canvas c, RecyclerView parent) {
        final int top = parent.getPaddingTop();
        final int bottom = parent.getHeight() - parent.getPaddingBottom();

        final int childCount = parent.getChildCount();
        for (int i = 0; i < childCount; i++) {
            final View child = parent.getChildAt(i);
            final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child
                    .getLayoutParams();
            final int left = child.getRight() + params.rightMargin;
            final int right = left + mDivider.getIntrinsicHeight();
            mDivider.setBounds(left, top, right, bottom);
            mDivider.draw(c);
        }
    }

    @Override
    public void getItemOffsets(Rect outRect, int itemPosition, RecyclerView parent) {
        if (mOrientation == VERTICAL_LIST) {
            outRect.set(0, 0, 0, mDivider.getIntrinsicHeight());
        } else {
            outRect.set(0, 0, mDivider.getIntrinsicWidth(), 0);
        }
    }
}

现在我们只需要在MainActivity的onCreate方法中添加如下代码即可添加分隔线了：

 mRecyclerView.addItemDecoration (new DividerItemDecoration (this,
                DividerItemDecoration.VERTICAL_LIST));

运行程序，效果如下：

test

由于原来的背景颜色太淡导致分隔线显示不明显，所以我换了一个背景色。

总结

在这篇文章里，我们对RecyclerView有了一个基本的认识并实现了它的一个简单用法，在接下来的几篇博文里，我将给您带来RecyclerView的更多用法。

下篇文章请戳Android RecyclerView的使用解析（二）

该系列文章首发在我的个人博客中

Android RecyclerView的使用解析（一）

前言

初识RecyclerView

简单的实现

总结

猜你喜欢

热点阅读