Android RecyclerView的使用解析（一）

前言

RecyclerView是Android5.0帶來的一個(gè)旨在替代ListView的新控件，收錄在android.support.v7.widget包下。轉(zhuǎn)眼之間，它已經(jīng)面世2年了，大家也或多或少了解或運(yùn)用過這個(gè)吊吊的控件，下面就由我?guī)ьI(lǐng)您走向RecyclerView的世界。

初識(shí)RecyclerView

我們先來看看這個(gè)控件的名字，所謂RecyclerView，意思就是老子只負(fù)責(zé)回收復(fù)用View，其它的事不管?？此焊邭鈸P(yáng)的樣子，你是不是想弄死它？其實(shí)啊，人家確實(shí)有裝B的資格，相比較ListView而言，我們可以更加靈活地定制控件的效果。
要使用RecyclerView，首先需要了解以下兩個(gè)相關(guān)的類：

  • LayoutManager

這個(gè)類主要用于控制RecyclerView的顯示規(guī)則的，它是一個(gè)抽象類，系統(tǒng)給我們提供了三個(gè)默認(rèn)的實(shí)現(xiàn)類，它們是LinearLayoutManager 、 GridLayoutManager和StaggeredGridLayoutManager。
從名字就可以看出，我們可以利用它們分別讓RecyclerView顯示線性布局，網(wǎng)格布局和瀑布流布局。

  • RecyclerView.Adapter

同ListView一樣，RecyclerView也提供一個(gè)適配器來控制每個(gè)item的顯示內(nèi)容。我們需要繼承RecyclerView.Adapter<VH extends VeiwHolder>，并將泛型中的類名指定為自定義的ViewHolder類名，接著創(chuàng)建一個(gè)靜態(tài)的自定義ViewHolder（RecyclerView幫我們封裝好了ViewHolder，我們只需要在它的基礎(chǔ)上實(shí)現(xiàn)功能即可），然后復(fù)寫以下三個(gè)方法：

  • onCreateViewHolder
    該方法主要為每一個(gè)item加載布局，并將布局傳遞給自定義的ViewHolder。

  • onBindViewHolder
    該方法主要是建立起自定義ViewHolder中視圖與數(shù)據(jù)的關(guān)聯(lián)。

  • getItemCount
    該方法用于對(duì)item進(jìn)行計(jì)數(shù)。

簡(jiǎn)單的實(shí)現(xiàn)

廢話不多說，下面我們來進(jìn)入實(shí)戰(zhàn)，首先我們要實(shí)現(xiàn)一個(gè)ListView顯示item項(xiàng)的效果。

在AS中新建一個(gè)項(xiàng)目，我們這里就叫做RecyclerViewTest吧，添加以下依賴：

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

接著在布局文件中創(chuàng)建我們的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>

并創(chuàng)建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的實(shí)例，并且為它設(shè)置適配器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);//這里我們使用默認(rèn)的線性布局管理器,將其設(shè)為垂直顯示
        mRecyclerView.setLayoutManager (mLayoutManager);//設(shè)置布局管理器
        mAdapter = new TestAdapter(this, mDataset);//實(shí)例化適配器
        mRecyclerView.setAdapter (mAdapter);//設(shè)置適配器
    }

    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);
        }
    }
}

接著我們就要?jiǎng)?chuàng)建自定義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;


    //提供一個(gè)合適的構(gòu)造方法
    public TestAdapter(Context context, List<String> dataset) {
        this.mContext = context;
        this.mDataset = dataset;
        mInflater = LayoutInflater.from (context);
    }

    /**
     *將布局轉(zhuǎn)換為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中視圖與數(shù)據(jù)的關(guān)聯(lián)
     * @param viewHolder
     * @param position
     */
    @Override
    public void onBindViewHolder(MyViewHolder viewHolder, int position) {
        viewHolder.mTextView.setText(mDataset.get (position));
    }

    /**
     * 獲取item的數(shù)目
     * @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);
        }
    }
}

現(xiàn)在，我們這個(gè)例子就可以正常運(yùn)行了，效果如下：


RecyclerView4ListView

恩？好像哪里不對(duì)！分割線哪里去了？以前用ListView時(shí)，我們還可以通過divider屬性來設(shè)置分割線，但到了RecyclerView這卻不行了。這位大爺除了回收復(fù)用外啥事都不管，什么設(shè)置分割線啊，給item設(shè)置動(dòng)畫效果啊等等它丫的統(tǒng)統(tǒng)拋在腦后！那是不是就沒轍了？肯定不是啦，前面我們就說過，我們可以自由地定制RecyclerView，那分割線這點(diǎn)芝麻大的事肯定也不在話下啦。

系統(tǒng)給我們提供了一個(gè)叫做ItemDecoration的抽象類，卻并沒有提供它的實(shí)現(xiàn)類供我們使用，所以我們必須通過自定義它去使用它，這里我就不重復(fù)造輪子啦，網(wǎng)上有很多現(xiàn)成的ItemDecoration的實(shí)現(xiàn)類，我們挑一個(gè)比較好用的來實(shí)現(xiàn)分割線效果:
在我們的項(xiàng)目中添加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);
        }
    }
}

現(xiàn)在我們只需要在MainActivity的onCreate方法中添加如下代碼即可添加分隔線了：

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

運(yùn)行程序，效果如下：


test

由于原來的背景顏色太淡導(dǎo)致分隔線顯示不明顯，所以我換了一個(gè)背景色。

總結(jié)

在這篇文章里，我們對(duì)RecyclerView有了一個(gè)基本的認(rèn)識(shí)并實(shí)現(xiàn)了它的一個(gè)簡(jiǎn)單用法，在接下來的幾篇博文里，我將給您帶來RecyclerView的更多用法。

下篇文章請(qǐng)戳Android RecyclerView的使用解析（二）

該系列文章首發(fā)在我的個(gè)人博客中

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容