轉載請說明出處:http://www.lxweimin.com/p/302d24db5423
今天給大家介紹的是一個可以實現數據分組顯示的RecyclerViewAdapter:GroupedRecyclerViewAdapter。它可以很方便的實現RecyclerView的分組顯示,并且每個組都可以包含組頭、組尾和子項;可以方便實現多種Type類型的列表,可以實現如QQ聯系人的列表一樣的列表展開收起功能等。下面先讓我們看一下它所能夠實現的一些效果:
還可以很容易的實時列表的展開收起效果:
以上展示的只是GroupedRecyclerViewAdapter能實現的一些常用效果,其實使用GroupedRecyclerViewAdapter還可以很容易的實現一些更加復雜的列表效果。在我的GroupedRecyclerViewAdapter項目的Demo中給出了上面幾種效果的實現例子,并且有詳細的注釋說明,有興趣的同學可以到我的GitHub下載源碼。下面直接講解GroupedRecyclerViewAdapter的使用。
**1、引入依賴 **
在Project的build.gradle在添加以下代碼
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
在Module的build.gradle在添加以下代碼
compile 'com.github.donkingliang:GroupedRecyclerViewAdapter:1.3.0'
2、繼承GroupedRecyclerViewAdapter
public class GroupedListAdapter extends GroupedRecyclerViewAdapter {
}
3、實現GroupedRecyclerViewAdapter里的方法
GroupedRecyclerViewAdapter是一個抽象類,它提供了一系列需要子類去實現的方法。
//返回組的數量
public abstract int getGroupCount();
//返回當前組的子項數量
public abstract int getChildrenCount(int groupPosition);
//當前組是否有頭部
public abstract boolean hasHeader(int groupPosition);
//當前組是否有尾部
public abstract boolean hasFooter(int groupPosition);
//返回頭部的布局id。(如果hasHeader返回false,這個方法不會執行)
public abstract int getHeaderLayout(int viewType);
//返回尾部的布局id。(如果hasFooter返回false,這個方法不會執行)
public abstract int getFooterLayout(int viewType);
//返回子項的布局id。
public abstract int getChildLayout(int viewType);
//綁定頭部布局數據。(如果hasHeader返回false,這個方法不會執行)
public abstract void onBindHeaderViewHolder(BaseViewHolder holder, int groupPosition);
//綁定尾部布局數據。(如果hasFooter返回false,這個方法不會執行)
public abstract void onBindFooterViewHolder(BaseViewHolder holder, int groupPosition);
//綁定子項布局數據。
public abstract void onBindChildViewHolder(BaseViewHolder holder,
int groupPosition, int childPosition);
還可是重寫GroupedRecyclerViewAdapter方法實現頭、尾和子項的多種類型item。效果就像上面的第6張圖一樣。
//返回頭部的viewType。
public int getHeaderViewType(int groupPosition);
//返回尾部的viewType。
public int getFooterViewType(int groupPosition) ;
//返回子項的viewType。
public int getChildViewType(int groupPosition, int childPosition) ;
4、設置點擊事件的監聽
GroupedRecyclerViewAdapter提供了對列表的點擊事件的監聽方法。
//設置組頭點擊事件
public void setOnHeaderClickListener(OnHeaderClickListener listener) {
mOnHeaderClickListener = listener;
}
//設置組尾點擊事件
public void setOnFooterClickListener(OnFooterClickListener listener) {
mOnFooterClickListener = listener;
}
// 設置子項點擊事件
public void setOnChildClickListener(OnChildClickListener listener) {
mOnChildClickListener = listener;
}
注意事項:
1、對方法重寫的注意。
如果我們直接繼承RecyclerView.Adapter去實現自己的Adapter時,一般會重寫Adapter中的以下幾個方法:
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType);
public void onBindViewHolder(RecyclerView.ViewHolder holder, int position);
public int getItemCount();
public int getItemViewType(int position);
但如果是使用GroupedRecyclerViewAdapter,就一定不能去重寫這幾個方法,因為在GroupedRecyclerViewAdapter中已經對這幾個方法做了實現,而且是對實現列表分組至關重要的,如果子類重寫了這幾個方法,可能會破壞GroupedRecyclerViewAdapter的功能。
從前面給出的GroupedRecyclerViewAdapter的方法我們可以看到,這些方法其實就是對應RecyclerView.Adapter的這4個方法的,所以我們直接使用GroupedRecyclerViewAdapter提供的方法即可。
RecyclerView.Adapter中的
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType);
對應GroupedRecyclerViewAdapter中的
//返回頭部的布局id。(如果hasHeader返回false,這個方法不會執行)
public abstract int getHeaderLayout(int viewType);
//返回尾部的布局id。(如果hasFooter返回false,這個方法不會執行)
public abstract int getFooterLayout(int viewType);
//返回子項的布局id。
public abstract int getChildLayout(int viewType);
這里之所以返回的是布局id而不是ViewHolder ,是因為在GroupedRecyclerViewAdapter項目中已經提供了一個通用的ViewHolder:BaseViewHolder。所以使用者只需要提供布局的id即可,不需要自己去實現ViewHolder。
@Override
public BaseViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
View view = LayoutInflater.from(mContext).inflate(getLayoutId(mTempPosition, viewType), parent, false);
return new BaseViewHolder(view);
}
private int getLayoutId(int position, int viewType) {
int type = judgeType(position);
if (type == TYPE_HEADER) {
return getHeaderLayout(viewType);
} else if (type == TYPE_FOOTER) {
return getFooterLayout(viewType);
} else if (type == TYPE_CHILD) {
return getChildLayout(viewType);
}
return 0;
}
RecyclerView.Adapter中的
public void onBindViewHolder(RecyclerView.ViewHolder holder, int position);
對應GroupedRecyclerViewAdapter中的
//綁定頭部布局數據。(如果hasHeader返回false,這個方法不會執行)
public abstract void onBindHeaderViewHolder(BaseViewHolder holder, int groupPosition);
//綁定尾部布局數據。(如果hasFooter返回false,這個方法不會執行)
public abstract void onBindFooterViewHolder(BaseViewHolder holder, int groupPosition);
//綁定子項布局數據。
public abstract void onBindChildViewHolder(BaseViewHolder holder,
int groupPosition, int childPosition);
RecyclerView.Adapter中的
public int getItemCount();
對應GroupedRecyclerViewAdapter中的
//返回組的數量
public abstract int getGroupCount();
//返回當前組的子項數量
public abstract int getChildrenCount(int groupPosition);
RecyclerView.Adapter中的
public int getItemViewType(int position);
對應GroupedRecyclerViewAdapter中的
//返回頭部的viewType。
public int getHeaderViewType(int groupPosition);
//返回尾部的viewType。
public int getFooterViewType(int groupPosition) ;
//返回子項的viewType。
public int getChildViewType(int groupPosition, int childPosition) ;
2、對列表操作的注意
RecyclerView.Adapter提供了一系列對列表進行操作的方法。如:
//更新操作
public final void notifyDataSetChanged();
public final void notifyItemChanged(int position);
public final void notifyItemChanged(int position, Object payload);
public final void notifyItemRangeChanged(int positionStart, int itemCount);
public final void notifyItemRangeChanged(int positionStart, int itemCount, Object payload);
//插入操作
public final void notifyItemInserted(int position);
public final void notifyItemRangeInserted(int positionStart, int itemCount);
//刪除操作
public final void notifyItemRemoved(int position)
public final void notifyItemRangeRemoved(int positionStart, int itemCount);
在GroupedRecyclerViewAdapter不建議使用RecyclerView.Adapter的任何對列表的操作方法,因為這些方法都是基于列表的操作,它的position是相對于整個列表而言的,而GroupedRecyclerViewAdapter是分組的列表,它對列表的操作應該是基于組的。同時GroupedRecyclerViewAdapter使用了組結構來維護整個列表的結構,使我們可以對列表進行組的操作,在列表發生變化時GroupedRecyclerViewAdapter需要及時對組結構進行調整,如果使用了RecyclerView.Adapter中的方法對列表進行更新,GroupedRecyclerViewAdapter可能因為無法及時調整組結構而發生異常。所以在使用中應該避免使用這些方法。GroupedRecyclerViewAdapter同樣提供了一系列對列表進行操作的方法,我們應該使用GroupedRecyclerViewAdapter所提供的方法。
//****** 刷新操作 *****//
//通知數據列表刷新。對應 notifyDataSetChanged();
public void notifyDataChanged();
//通知一組數據刷新,包括組頭,組尾和子項
public void notifyGroupChanged(int groupPosition);
//通知多組數據刷新,包括組頭,組尾和子項
public void notifyGroupRangeChanged(int groupPosition, int count);
// 通知組頭刷新
public void notifyHeaderChanged(int groupPosition);
// 通知組尾刷新
public void notifyFooterChanged(int groupPosition);
// 通知一組里的某個子項刷新
public void notifyChildChanged(int groupPosition, int childPosition);
// 通知一組里的多個子項刷新
public void notifyChildRangeChanged(int groupPosition, int childPosition, int count);
// 通知一組里的所有子項刷新
public void notifyChildrenChanged(int groupPosition);
//****** 刪除操作 *****//
// 通知所有數據刪除
public void notifyDataRemoved();
// 通知一組數據刪除,包括組頭,組尾和子項
public void notifyGroupRemoved(int groupPosition);
// 通知多組數據刪除,包括組頭,組尾和子項
public void notifyGroupRangeRemoved(int groupPosition, int count);
// 通知組頭刪除
public void notifyHeaderRemoved(int groupPosition);
// 通知組尾刪除
public void notifyFooterRemoved(int groupPosition);
// 通知一組里的某個子項刪除
public void notifyChildRemoved(int groupPosition, int childPosition);
// 通知一組里的多個子項刪除
public void notifyChildRangeRemoved(int groupPosition, int childPosition, int count);
// 通知一組里的所有子項刪除
public void notifyChildrenRemoved(int groupPosition);
//****** 插入操作 *****//
// 通知一組數據插入
public void notifyGroupInserted(int groupPosition);
// 通知多組數據插入
public void notifyGroupRangeInserted(int groupPosition, int count);
// 通知組頭插入
public void notifyHeaderInserted(int groupPosition);
// 通知組尾插入
public void notifyFooterInserted(int groupPosition);
// 通知一個子項到組里插入
public void notifyChildInserted(int groupPosition, int childPosition);
// 通知一組里的多個子項插入
public void notifyChildRangeInserted(int groupPosition, int childPosition, int count);
// 通知一組里的所有子項插入
public void notifyChildrenInserted(int groupPosition);
3、使用GridLayoutManager的注意
如果要使用GridLayoutManager,一定要使用項目中所提供的GroupedGridLayoutManager。因為分組列表如果要使用GridLayoutManager實現網格布局,就要保證組的頭部和尾部是要單獨占用一行的。否則組的頭、尾可能會跟子項混著一起,造成布局混亂。同時GroupedGridLayoutManager提供了對子項的SpanSize的修改方法,使用GroupedGridLayoutManager可以實現更多的復雜列表布局。
//直接使用GroupedGridLayoutManager實現子項的Grid效果
GroupedGridLayoutManager gridLayoutManager = new GroupedGridLayoutManager(this, 2, adapter);
rvList.setLayoutManager(gridLayoutManager);
GroupedGridLayoutManager gridLayoutManager = new GroupedGridLayoutManager(this, 4, adapter){
//重寫這個方法 改變子項的SpanSize。
//這個跟重寫SpanSizeLookup的getSpanSize方法的使用是一樣的。
@Override
public int getChildSpanSize(int groupPosition, int childPosition) {
if(groupPosition % 2 == 1){
return 2;
}
return super.getChildSpanSize(groupPosition, childPosition);
}
};
rvList.setLayoutManager(gridLayoutManager);
4、BaseViewHolder的使用
項目中提供了一個通用的ViewHolder:BaseViewHolder。提供了根據viewId獲取View的方法和對View、TextView、ImageView的常用設置方法。
//根據id獲取View
TextView textView = holder.get(R.id.tv_header);
//View、TextView、ImageView的常用設置方法。并且支持方法連綴調用
holder.setText(R.id.tv_header, "內容")
.setImageResource(R.id.iv_image, 資源id)
.setBackgroundRes(R.id.view,資源id);
BaseViewHolder是可以通用的,在普通的Adapter中也可以使用,可以省去每次都要創建ViewHolder的麻煩。
下面看一個簡單的使用列子:
public class GroupedListAdapter extends GroupedRecyclerViewAdapter {
private ArrayList<GroupEntity> mGroups;
public GroupedListAdapter(Context context, ArrayList<GroupEntity> groups) {
super(context);
mGroups = groups;
}
@Override
public int getGroupCount() {
return mGroups == null ? 0 : mGroups.size();
}
@Override
public int getChildrenCount(int groupPosition) {
ArrayList<ChildEntity> children = mGroups.get(groupPosition).getChildren();
return children == null ? 0 : children.size();
}
@Override
public boolean hasHeader(int groupPosition) {
return true;
}
@Override
public boolean hasFooter(int groupPosition) {
return true;
}
@Override
public int getHeaderLayout(int viewType) {
return R.layout.adapter_header;
}
@Override
public int getFooterLayout(int viewType) {
return R.layout.adapter_footer;
}
@Override
public int getChildLayout(int viewType) {
return R.layout.adapter_child;
}
@Override
public void onBindHeaderViewHolder(BaseViewHolder holder, int groupPosition) {
GroupEntity entity = mGroups.get(groupPosition);
holder.setText(R.id.tv_header, entity.getHeader());
}
@Override
public void onBindFooterViewHolder(BaseViewHolder holder, int groupPosition) {
GroupEntity entity = mGroups.get(groupPosition);
holder.setText(R.id.tv_footer, entity.getFooter());
}
@Override
public void onBindChildViewHolder(BaseViewHolder holder, int groupPosition, int childPosition) {
ChildEntity entity = mGroups.get(groupPosition).getChildren().get(childPosition);
holder.setText(R.id.tv_child, entity.getChild());
}
}
public class GroupedListActivity extends AppCompatActivity {
private TextView tvTitle;
private RecyclerView rvList;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_group_list);
tvTitle = (TextView) findViewById(R.id.tv_title);
rvList = (RecyclerView) findViewById(R.id.rv_list);
tvTitle.setText(R.string.group_list);
rvList.setLayoutManager(new LinearLayoutManager(this));
GroupedListAdapter adapter = new GroupedListAdapter(this, GroupModel.getGroups(10, 5));
adapter.setOnHeaderClickListener(new GroupedRecyclerViewAdapter.OnHeaderClickListener() {
@Override
public void onHeaderClick(GroupedRecyclerViewAdapter adapter, BaseViewHolder holder,
int groupPosition) {
Toast.makeText(GroupedListActivity.this, "組頭:groupPosition = " + groupPosition,
Toast.LENGTH_LONG).show();
}
});
adapter.setOnFooterClickListener(new GroupedRecyclerViewAdapter.OnFooterClickListener() {
@Override
public void onFooterClick(GroupedRecyclerViewAdapter adapter, BaseViewHolder holder,
int groupPosition) {
Toast.makeText(GroupedListActivity.this, "組尾:groupPosition = " + groupPosition,
Toast.LENGTH_LONG).show();
}
});
adapter.setOnChildClickListener(new GroupedRecyclerViewAdapter.OnChildClickListener() {
@Override
public void onChildClick(GroupedRecyclerViewAdapter adapter, BaseViewHolder holder,
int groupPosition, int childPosition) {
Toast.makeText(GroupedListActivity.this, "子項:groupPosition = " + groupPosition
+ ", childPosition = " + childPosition,
Toast.LENGTH_LONG).show();
}
});
rvList.setAdapter(adapter);
}
}
這是我在項目Demo中的實現的其中一個列子。效果是上面的圖1。想看源碼和更多的使用列子的歡迎訪問我的GitHub。
頭部懸浮吸頂功能
應一些朋友的反饋,我在1.2.0版本中新加了列表的頭部懸浮吸頂功能。使用起來非常的簡單,只需要用框架里提供的StickyHeaderLayout包裹一下你的RecyclerView就可以了。當然,你需要使用GroupedRecyclerViewAdapter才能看到效果。
<!-- 用StickyHeaderLayout包裹RecyclerView -->
<com.donkingliang.groupedadapter.widget.StickyHeaderLayout
android:id="@+id/sticky_layout"
android:layout_width="match_parent"
android:layout_height="match_parent">
<android.support.v7.widget.RecyclerView
android:id="@+id/rv_list"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</com.donkingliang.groupedadapter.widget.StickyHeaderLayout>
StickyHeaderLayout提供了一個設置是否顯示懸浮吸頂的方法。
//是否吸頂,默認為true。
stickyLayout.setSticky(true);
對懸浮吸頂功能的更多介紹,請看我的另一篇文章:《Android RecyclerView實現頭部懸浮吸頂效果》
效果圖:
使用DataBinding
GroupedRecyclerViewAdapter在1.3.0版本加入了對DataBinding的支持。要想在Adapter中使用DataBinding,只需要在GroupedRecyclerViewAdapter的構造函數的useBinding參數傳true即可。
public class BindingAdapter extends GroupedRecyclerViewAdapter {
public BindingAdapter(Context context) {
//只要在這里傳true,Adapter就會用DataBinding的方式加載列表的item布局。默認為false。
super(context, true);
}
}
然后同過BaseViewHolder的getBinding()就可以獲取到item對應的ViewDataBinding對象。
@Override
public void onBindHeaderViewHolder(BaseViewHolder holder, int groupPosition) {
//獲取ViewDataBinding對象。
AdapterBindingHeaderBinding binding = holder.getBinding();
}
@Override
public void onBindFooterViewHolder(BaseViewHolder holder, int groupPosition) {
//獲取ViewDataBinding對象。
AdapterBindingFooterBinding binding = holder.getBinding();
}
@Override
public void onBindChildViewHolder(BaseViewHolder holder, int groupPosition, int childPosition) {
//獲取ViewDataBinding對象。
AdapterBindingChildBinding binding = holder.getBinding();
}