谷歌在2014年6月26日的I/O 2014開發(fā)者大會上正式推出了Android L, 其中RecyclerView 也是在這次發(fā)布會上提出的。RecyclerView是一種新的視圖組,目標是為任何基于適配器的視圖提供相似的渲染方式。它被作為ListView和GridView控件的繼承者。
用過ListView 和RecyclerView的朋友肯定會發(fā)現(xiàn):
- RecyclerView 沒有HeaderView 和 footerView。
- RecyclerView 沒有 ItemClick事件。
- RecyclerView 沒有 setEmptyView。
RecyclerView的優(yōu)點也很明顯:
- 強大的視圖布局管理器。(可以使用橫向、縱向、網(wǎng)格布局)
- 默認的ViewHolder重用機制。
- 強大的動畫效果。(https://github.com/wasabeef/recyclerview-animators)
本篇文章主要是為Recyclerview添加headerView 和 footerView。
在接觸一個新功能的時,可能因為沒有接觸過導(dǎo)致有一種無從下手的感覺。在這里,我們不妨看看ListView是如何實現(xiàn)HeaderView 和 FooterView;
我們進入listView.setAdapter()方法中:
@Override
public void setAdapter(ListAdapter adapter) {
if (mAdapter != null && mDataSetObserver != null) {
//取消上一個數(shù)據(jù)觀察者
mAdapter.unregisterDataSetObserver(mDataSetObserver);
}
.............
//判斷是否添加了headerView 和 footerView
if (mHeaderViewInfos.size() > 0|| mFooterViewInfos.size() > 0) {
mAdapter = new HeaderViewListAdapter(mHeaderViewInfos, mFooterViewInfos, adapter);
} else {
mAdapter = adapter;
}
.............
// AbsListView#setAdapter will update choice mode states.
super.setAdapter(adapter);
if (mAdapter != null) {
.............
//重新為adapter注冊一個觀察者
mDataSetObserver = new AdapterDataSetObserver();
mAdapter.registerDataSetObserver(mDataSetObserver);
..............
}
.............
}
在這里我們看到有一個AdapterDataSetObserver類,這是一個數(shù)據(jù)觀察者,在我們調(diào)用adapter.notifyDataSetChang()的時候,adapter會通知所有訂閱它的觀察者更新數(shù)據(jù)。在里面我們可以看到其中有一個類名為HeaderViewListAdapter類,從類名上我們就可以看出來這和 headerView有關(guān)系。我繼續(xù)點進去看看里面的具體內(nèi)容。
public HeaderViewListAdapter(ArrayList<ListView.FixedViewInfo> headerViewInfos,
ArrayList<ListView.FixedViewInfo> footerViewInfos,
ListAdapter adapter) {
mAdapter = adapter;
mIsFilterable = adapter instanceof Filterable;
if (headerViewInfos == null) {
mHeaderViewInfos = EMPTY_INFO_LIST;
} else {
mHeaderViewInfos = headerViewInfos;
}
if (footerViewInfos == null) {
mFooterViewInfos = EMPTY_INFO_LIST;
} else {
mFooterViewInfos = footerViewInfos;
}
//判斷headerView 和 footerView 是否可以點擊
mAreAllFixedViewsSelectable =
areAllListInfosSelectable(mHeaderViewInfos)
&& areAllListInfosSelectable(mFooterViewInfos);
構(gòu)造方法比較簡單, 主要是判斷是否有headerView 和 footerView, 以及它們是否可以進行選擇。在平時寫adapter的時候就知道adapter最主要是在getView()方法中,我們在去看看getView()方法是如何實現(xiàn)的。
public View getView(int position, View convertView, ViewGroup parent) {
// Header (negative positions will throw an IndexOutOfBoundsException)
int numHeaders = getHeadersCount();
if (position < numHeaders) {
//返回headerView
return mHeaderViewInfos.get(position).view;
}
// Adapter
final int adjPosition = position - numHeaders;
int adapterCount = 0;
if (mAdapter != null) {
//adapter的實際位置
adapterCount = mAdapter.getCount();
if (adjPosition < adapterCount) {
return mAdapter.getView(adjPosition, convertView, parent);
}
}
// Footer (off-limits positions will throw an IndexOutOfBoundsException)
// 返回footerView
return mFooterViewInfos.get(adjPosition - adapterCount).view;
}
在這個方法中,我們可以看到如果 position 位置 小于headerViewCount 時候,說明現(xiàn)在應(yīng)該返回headerView,而當 adjPosition 小于 adapterCount的時候 說明現(xiàn)在應(yīng)該返回 被包裝的adapter.getView()方法,其余的時候直接 返回footerView。在理解getView()方法后,
繼續(xù)看getItemViewType()、getItemId()、getItem()等方法,發(fā)現(xiàn)他們實現(xiàn)的方式 和 getView() 的邏輯 大同小異。
在理解listView的封裝邏輯之后, 我們就可以模仿它來 封裝RecyclerView。
第一步,引入RecyclerView架包
在build.gradle 添加依賴
compile 'com.android.support:recyclerview-v7:24.0.0'
第二步,自定義RecyclerView
import android.content.Context;
import android.support.annotation.Nullable;
import android.support.v7.widget.RecyclerView;
import android.util.AttributeSet;
import android.view.View;
import java.util.ArrayList;
import java.util.List;
/**
* Created by User on 2016/11/7.
*/
public class HeaderRecyclerView extends RecyclerView {
private List<View> mHeaderViews = new ArrayList<>();
private List<View> mFooterViews = new ArrayList<>();
private HeaderViewAdapter mAdapter;
public HeaderRecyclerView(Context context) {
super(context);
}
public HeaderRecyclerView(Context context, @Nullable AttributeSet attrs) {
super(context, attrs);
}
public HeaderRecyclerView(Context context, @Nullable AttributeSet attrs, int defStyle) {
super(context, attrs, defStyle);
}
public void removeHeaderView(View view) {
if (mHeaderViews.contains(view)) {
mHeaderViews.remove(view);
}
if (mAdapter != null) {
mAdapter.notifyDataSetChanged();
}
}
public void removeFooterView(View view) {
if (mFooterViews.contains(view)) {
mFooterViews.remove(view);
}
if (mAdapter != null) {
mAdapter.notifyDataSetChanged();
}
}
public void addHeaderView(View view) {
mHeaderViews.add(view);
if (mAdapter != null) {
mAdapter.notifyDataSetChanged();
}
}
public void addFooterView(View view) {
mFooterViews.add(view);
if (mAdapter != null) {
mAdapter.notifyDataSetChanged();
}
}
@Override
public void setAdapter(Adapter adapter) {
if (mAdapter != null) {
//移除上一次的觀察者
mAdapter.unregisterDataSetObserver(mAdapterDataObserver);
}
mAdapter = new HeaderViewAdapter(adapter, mHeaderViews, mFooterViews);
//重新注冊一個新的觀察者
mAdapter.registerDataSetObserver(mAdapterDataObserver);
super.setAdapter(mAdapter);
}
//數(shù)據(jù)觀察者
private AdapterDataObserver mAdapterDataObserver = new AdapterDataObserver() {
@Override
public void onChanged() {
mAdapter.notifyDataSetChanged();
}
@Override
public void onItemRangeChanged(int positionStart, int itemCount) {
mAdapter.notifyItemRangeChanged(positionStart + mHeaderViews.size(), itemCount);
}
@Override
public void onItemRangeChanged(int positionStart, int itemCount, Object payload) {
mAdapter.notifyItemRangeChanged(positionStart + mHeaderViews.size(), itemCount, payload);
}
@Override
public void onItemRangeInserted(int positionStart, int itemCount) {
mAdapter.notifyItemRangeInserted(positionStart + mHeaderViews.size(), itemCount);
}
@Override
public void onItemRangeRemoved(int positionStart, int itemCount) {
mAdapter.notifyItemRangeRemoved(positionStart + mHeaderViews.size(), itemCount);
}
};
}
上面是我們的自定義的RecyclerView, 最主要的是在setAdapter()中添加 數(shù)據(jù)觀察者。
第三步, 編寫HeaderViewAdapter
import android.support.v7.widget.RecyclerView;
import android.view.View;
import android.view.ViewGroup;
import java.util.List;
/**
* Created by User on 2016/11/2.
*/
public class HeaderViewAdapter extends RecyclerView.Adapter {
private List<View> headerView;
private List<View> footerView;
private RecyclerView.Adapter tagAdapter;
//定義FooterView類型 和 HeaderView類型
private final static int HEADER_VIEW_TYPE = Integer.MAX_VALUE / 123;
private final static int FOOTER_VIEW_TYPE = Integer.MAX_VALUE / 321;
public HeaderViewAdapter(RecyclerView.Adapter tagAdapter, List<View> headerViews, List<View> footerViews) {
this.tagAdapter = tagAdapter;
this.headerView = headerViews;
this.footerView = footerViews;
}
@Override
public int getItemViewType(int position) {
int headerNums = headerView.size();
if (headerNums > position) return HEADER_VIEW_TYPE;
if (position >= headerNums) {
int adCount = tagAdapter.getItemCount();
int adjPosition = position - headerNums;
if (adjPosition < adCount) {
return tagAdapter.getItemViewType(adjPosition);
}
}
return FOOTER_VIEW_TYPE;
}
@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
switch (viewType) {
case HEADER_VIEW_TYPE:
return new HeaderOrFooterView(headerView.get(0));
case FOOTER_VIEW_TYPE:
return new HeaderOrFooterView(footerView.get(0));
default:
return tagAdapter.onCreateViewHolder(parent, viewType);
}
}
@Override
public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
int headerNum = headerView.size();
if (position >= headerNum) {
int adCount = tagAdapter.getItemCount();
int adjPosition = position - headerNum;
if (adjPosition < adCount) {
tagAdapter.onBindViewHolder(holder, adjPosition);
}
}
}
/**
* 添加支持GridLayoutManager
* @param recyclerView
*/
@Override
public void onAttachedToRecyclerView(RecyclerView recyclerView) {
super.onAttachedToRecyclerView(recyclerView);
RecyclerView.LayoutManager manager = recyclerView.getLayoutManager();
if (manager instanceof GridLayoutManager) {
final GridLayoutManager gridLayoutManager = (GridLayoutManager) manager;
gridLayoutManager.setSpanSizeLookup(new GridLayoutManager.SpanSizeLookup() {
@Override
public int getSpanSize(int position) {
return (isHeaderView(position) || isFooterView(position)) ? gridLayoutManager.getSpanCount() : 1;
}
});
}
}
/**
* 添加支持StaggeredGridLayoutManager
* @param holder
*/
@Override
public void onViewAttachedToWindow(RecyclerView.ViewHolder holder) {
super.onViewAttachedToWindow(holder);
ViewGroup.LayoutParams layoutParams = holder.itemView.getLayoutParams();
if (null != layoutParams && layoutParams instanceof StaggeredGridLayoutManager.LayoutParams) {
if (isFooterView(holder.getLayoutPosition()) || isHeaderView(holder.getLayoutPosition())) {
StaggeredGridLayoutManager.LayoutParams params = (StaggeredGridLayoutManager.LayoutParams) layoutParams;
params.setFullSpan(true);
}
}
}
private boolean isHeaderView(int position) {
if (position < headerView.size()) {
return true;
}
return false;
}
private boolean isFooterView(int position) {
int headerSize = headerView.size();
int footerSize = footerView.size();
int adSize = tagAdapter.getItemCount();
if ( position >= headerSize + adSize && position < headerSize + footerSize + adSize) {
return true;
}
return false;
}
@Override
public int getItemCount() {
return tagAdapter.getItemCount() + headerView.size() + footerView.size();
}
public void registerDataSetObserver(RecyclerView.AdapterDataObserver mDataObserver) {
if (tagAdapter != null) {
tagAdapter.registerAdapterDataObserver(mDataObserver);
}
}
public void unregisterDataSetObserver(RecyclerView.AdapterDataObserver mDataObserver) {
if (tagAdapter != null) {
tagAdapter.unregisterAdapterDataObserver(mDataObserver);
}
}
/**
* headerView 和 footerView ViewHolder的持有類
*/
class HeaderOrFooterView extends RecyclerView.ViewHolder {
public HeaderOrFooterView(View itemView) {
super(itemView);
}
}
}
在寫完這個類的時候, 我們基本已經(jīng)完成了 RecyclerView 的 headerView 和 footerView的封裝了。
在最后讓我們預(yù)覽下最終的效果:
headerView 和 footerView 已經(jīng)成功添加進了。至此,我們已經(jīng)完成了對 RecyclerView 進行簡單的封裝 headerView 和 footerView。
感謝大家的閱讀。如果發(fā)現(xiàn)本文理解的不對的地方,歡迎指出,一起學習,一起進步!
更新:添加支持網(wǎng)格布局和瀑布流布局