知識框架（腦圖）

RecyclerView腦圖

技術出現的背景

• ListView沒有強制要求ViewHolder
• ListView不能快速實現線性、網格和瀑布流效果
• ListView和GridView設計上重合度高
• MD設計的流行

解決的思路

• 使用RecyclerView統一ListView和GridView
• RecyclerView內部提供Adapter并強制要求提供ViewHolder
• RecyclerView內部提供LayoutManager并提供線性、網格和瀑布流的實現
• RecyclerView內部提供ItemAnimator并默認實現列表項刪除和添加動畫

RecyclerView設計思路

理念：簡化數據的顯示操作和處理大數據集

Adapter：提供view來顯示數據集中的元素
LayoutManager：放置元素到布局中
ItemAnimator：設置添加和移除元素的動畫

具體步驟

1. 添加依賴庫并在layout文件中引入RecyclerView

（1）添加依賴

compile 'com.android.support:recyclerview-v7:21.0.+'

（2） 引入RecyclerView

<android.support.v7.widget.RecyclerView
    android :id= "@+id/recycler_news"
    android :layout_width= "match_parent"
    android :layout_height= "match_parent" />

2. 指定RecyclerView是否固定大小

如果Adapter的變化不會影響RecyclerView的大小，也就是說RecyclerView的大小跟里面的列表項的多少和大小無關的話，請設置setHasFixedSize( true)，這樣可以提高性能，因為不同去動態計算RecyclerView的大小。

mRecyclerView.setHasFixedSize( true) ;

3. 新建并設置LayoutManager

private RecyclerView.LayoutManager mLayoutManager;
// 線性布局，可以設置方向
mLayoutManager = new LinearLayoutManager(this);
// or 網格布局，可以設置列數和方向，是否反向顯示
mLayoutManager = new GridLayoutManager(this,2,LinearLayoutManager.HORIZONTAL,false);
// or 瀑布流布局，可以設置列數和方向
mLayoutManager = new StaggeredGridLayoutManager(2,StaggeredGridLayoutManager.VERTICAL);
mRecyclerView.setLayoutManager(mLayoutManager);

4. 繼承并設置Adapter

（1）新建Adapter類，繼承自RecyclerView.Adapter
（2）新建ViewHolder內部類，繼承自RecyclerView.ViewHolder并讓Adapter的泛型設為該內部類
（3）實現Adapter的方法
1. 構造方法：一般用于接收數據集
2. onCreateViewHolder：用于從列表項布局文件中裝載布局并新建一個ViewHolder裝入列表項視圖
3. onBindViewHolder：用于數據和ViewHolder（視圖 ）的綁定
4. getItemCount：用于指定數據項的多少

public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {
    private String[] mDataset;

    // 提供視圖和數據項之間的引用
    public static class ViewHolder extends RecyclerView.ViewHolder {
        // each data item is just a string in this case
        public TextView mTextView;
        public ViewHolder(TextView v) {
            super(v);
            mTextView = v;
        }
    }

    // 依賴于數據集的構造方法
    public MyAdapter(String[] myDataset) {
        mDataset = myDataset;
    }

    // 創建一個新的View (由布局管理器調用)
    @Override
    public MyAdapter.ViewHolder onCreateViewHolder(ViewGroup parent,
                                                  int viewType) {
        View v = LayoutInflater.from(parent.getContext())
                              .inflate(R.layout.my_text_view, parent, false);
        ...
        ViewHolder vh = new ViewHolder(v);
        return vh;
    }

    // 替換View的內容 (由布局管理器調用)
    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        // - 獲取數據集中該position的元素
        // - 使用該元素替換View的內容
        holder.mTextView.setText(mDataset[position]);

    }

    // 返回數據集的大小 (由布局管理器調用)
    @Override
    public int getItemCount() {
        return mDataset.length;
    }
}

Q&A

問題1：如何設置列表項點擊事件？

（1） 解決思路

使用Java的回調機制

（2） 具體解決方法

在Adapter中提供OnItemClickListener接口和設置接口的方法

public interface OnItemClickListener {
    void onItemClick(View View, int position);
}

private OnItemClickListener onItemClickListener;

public void setOnItemClickListener(OnItemClickListener onItemClickListener) {
    this.onItemClickListener = onItemClickListener;
}

在onBindViewHolder方法中設置點擊監聽器并調用接口方法

if (onItemClickListener != null) {
    holder.itemView.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            onItemClickListener.onItemClick(holder.itemView, newPosition);
        }
    });
}

在Activity/Fragment中實現接口方法

@Override
public void onNewsItemClick(String newsId) {
    // do sth.
}

問題2：如何實現上拉加載？

（1）解決思路

給RecyclerView添加OnScrollListener，判定是否到達底部，然后執行加載更多操作

（2）具體步驟

mRecyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
    @Override
    public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
    }

    @Override
    public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
        //得到當前顯示的最后一個item的view
        View lastChildView = recyclerView.getLayoutManager().getChildAt(recyclerView.getLayoutManager().getChildCount()-1);
        //得到lastChildView的bottom坐標值
        int lastChildBottom = lastChildView.getBottom();
        //得到Recyclerview的底部坐標減去底部padding值，也就是顯示內容最底部的坐標
        int recyclerBottom =  recyclerView.getBottom()-recyclerView.getPaddingBottom();
        //通過這個lastChildView得到這個view當前的position值
        int lastPosition  = recyclerView.getLayoutManager().getPosition(lastChildView);

        //判斷lastChildView的bottom值跟recyclerBottom
        //判斷lastPosition是不是最后一個position
        //如果兩個條件都滿足則說明是真正的滑動到了底部
        if(lastChildBottom == recyclerBottom && lastPosition == recyclerView.getLayoutManager().getItemCount()-1 ){
            Toast.makeText(getContext(), "滑動到底了", Toast.LENGTH_SHORT).show();
        }
    }
});

問題3：如何實現下拉刷新？

（1）解決思路

使用SwipeRefreshLayout包裹RecyclerView，并設置OnRefreshListener

（2）具體步驟
// 略

問題4：如何添加Header和Footer？

（1）解決思路

重寫Adapter的getItemViewType方法，使得不同索引位置的ItemView定義為不同的類型。
要修改onCreateViewHolder、onBindViewHolder、getItemCount方法以及ViewHolder的構造方法。

（2）具體步驟

提供HeaderView的獲取和設置方法

public void setHeaderView(View headerView) {
    mHeaderView = headerView;
    notifyItemInserted(0);
}

public View getHeaderView() {
    return mHeaderView;
}

定義兩種列表項類型

public static final int TYPE_HEADER = 0;
public static final int TYPE_NORMAL = 1;

重寫getItemViewType方法

@Override
public int getItemViewType(int position) {
    if(mHeaderView == null) return TYPE_NORMAL;
    if(position == 0) return TYPE_HEADER;
    return TYPE_NORMAL;
}

修改onCreateViewHolder、onBindViewHolder、getItemCount方法以及ViewHolder的構造方法

@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    if(mHeaderView != null && viewType == TYPE_HEADER) return new Holder(mHeaderView);
    View layout = LayoutInflater.from(parent.getContext()).inflate(R.layout.item, parent, false);
    return new Holder(layout);
}

@Override
public void onBindViewHolder(RecyclerView.ViewHolder viewHolder, int position) {
    if(getItemViewType(position) == TYPE_HEADER) return;
    final int pos = getRealPosition(viewHolder);
    final String data = mDatas.get(pos);
    if(viewHolder instanceof Holder) {
        ((Holder) viewHolder).text.setText(data);
    }
}

public int getRealPosition(RecyclerView.ViewHolder holder) {
    int position = holder.getLayoutPosition();
    return mHeaderView == null ? position : position - 1;
}

@Override
public int getItemCount() {
    return mHeaderView == null ? mDatas.size() : mDatas.size() + 1;
}

class Holder extends RecyclerView.ViewHolder {
    TextView text;
    public Holder(View itemView) {
        super(itemView);
        if(itemView == mHeaderView) return;
        text = (TextView) itemView.findViewById(R.id.text);
    }
}

問題5：如何添加列表項的分隔線？

（1）解決思路

RecyclerView內部提供ItemDecoration抽象類，用于實現列表項之間的分割線、高亮或分組。

• 提供getItemOffsets方法用于設置列表項之間的間隔；
• 提供onDraw方法在列表項之前繪制分割線；
• 提供onDrawOver方法在列表下之后繪制分割線。

使用addItemDecoration方法可以給RecyclerView添加ItemDecoration。

（2）使用步驟

以設置列表項之間的間隔為例

mRecyclerView.addItemDecoration(new RecyclerView.ItemDecoration() {
    @Override
    public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
        super.getItemOffsets(outRect, view, parent, state);
        if (parent.getChildAdapterPosition(view) != 0) { //排除第一個
            outRect.top = getContext().getResources().getDimensionPixelSize(R.dimen.list_item_vertical_margin);
        }
    }
});

問題6：如何自定義添加和刪除動畫？

（1）解決思路

RecyclerView默認使用DefaultItemAnimator，要自定義的話，需要繼承ItemAnimator，并調用RecyclerView的addItemAnimator方法。

（2）具體步驟

//todo

問題7：StaggeredGridLayoutManager為什么不需要傳入Context？

三個LayoutManager之間的關系

LinearLayoutManager中雖然要求要Context，但是實際上內部并沒有使用，可能是留待以后擴展用，GridLayoutManager繼承自LinearLayoutManager，所以也需要Context；StaggeredGridLayoutManager在設計時就不要求Context。

參考文檔

1. 創建列表和卡片
2. RecyclerView用法介紹
3. RecyclerView添加Header的正確方式
4. Android中Recyclerview監聽是否滑動到底部