前言
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);
}
}
}
現在，我們這個例子就可以正常運行了，效果如下：
恩？好像哪里不對！分割線哪里去了？以前用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));
運行程序，效果如下：
由于原來的背景顏色太淡導致分隔線顯示不明顯，所以我換了一個背景色。
總結
在這篇文章里，我們對RecyclerView有了一個基本的認識并實現了它的一個簡單用法，在接下來的幾篇博文里，我將給您帶來RecyclerView的更多用法。
下篇文章請戳Android RecyclerView的使用解析（二）
該系列文章首發在我的個人博客中
- Android RecyclerView的使用解析（一）
- Android RecyclerView的使用解析（二）
- Android RecyclerView的使用解析（完結篇）
