github源碼地址:https://github.com/zhou-you/EasyXRecyclerView
萬(wàn)能適配器Adapter功能介紹
RecyclerView適配器的傳統(tǒng)使用方法是繼承RecyclerView.Adapter<RecyclerView.ViewHolder>
相信大家都很清楚(不清楚的請(qǐng)先自行學(xué)習(xí)官方使用方式),這里為什么提供一種萬(wàn)能適配器呢悼瘾?主要是方便快捷的開發(fā)易桃,一種最佳偷懶姿勢(shì)瑟枫,打造屬于RecyclerView的萬(wàn)能適配器Adapter和ViewHolder妆偏、以及更簡(jiǎn)單方便的數(shù)據(jù)綁定和操作。
特性
- 優(yōu)化了Adapter代碼海洼,減少了代碼量
- 簡(jiǎn)單配置拧揽、無(wú)需重寫額外方法
- 添加Item事件
- Item的點(diǎn)擊事件
- Item的長(zhǎng)按事件
- 添加列表加載動(dòng)畫
- 一行代碼輕松切換5種默認(rèn)動(dòng)畫
- 支持添加分組
- 隨心定義分組頭部、尾部
- 支持點(diǎn)擊展開收起
- 支持配置是否帶組頭或組尾(組頭灶挟、組尾是否顯示)
- 子項(xiàng)為Grid(并支持Span不同)
- 頭琉朽、尾、子項(xiàng)支持多種類型
- 支持分組帶有Sticky黏性效果
- 分組增加狀態(tài)頁(yè)面占位顯示(加載中稚铣、錯(cuò)誤頁(yè)面箱叁、空頁(yè)面、內(nèi)容頁(yè)面)
- 自定義不同的item類型
- 支持添加item拖拽
- 支持自定義ViewHolder惕医,讓開發(fā)者隨心所欲
主要相關(guān)類介紹
類名 | 功能 | 備注 |
---|---|---|
BaseRecyclerViewAdapter | 萬(wàn)能適配器基類 | 繼承該類該就可體驗(yàn)極簡(jiǎn)適配器用法耕漱、也可繼承該類擴(kuò)展功能。 |
HelperRecyclerViewAdapter | 提供便捷數(shù)據(jù)操作的萬(wàn)能適配器抬伺,繼承BaseRecyclerViewAdapter | 此類在萬(wàn)能適配的基礎(chǔ)上增加了數(shù)據(jù)操作螟够,可以直接繼承該類實(shí)現(xiàn)適配器 (推薦用法)。 |
HelperRecyclerViewAnimAdapter | 提供帶有動(dòng)畫效果的萬(wàn)能適配器峡钓,繼承HelperRecyclerViewAdapter | 如果不需要?jiǎng)赢嬓Ч梭希?qǐng)直接使用HelperRecyclerViewAdapter。 |
HelpRecyclerViewDragAdapter | 提供帶有拖拽效果的萬(wàn)能適配器椒楣,繼承HelperRecyclerViewAdapter | 如果不需要拖拽效果给郊,請(qǐng)直接使用HelperRecyclerViewAdapter。 |
HelperStateRecyclerViewAdapter | 提供帶有狀態(tài)頁(yè)面的萬(wàn)能適配器捧灰,繼承HelperRecyclerViewAdapter | 繼承該類該就可配置頁(yè)面加載中淆九、錯(cuò)誤统锤、空頁(yè)面、內(nèi)容頁(yè)面之間自由切換炭庙。 |
GroupedRecyclerViewAdapter | 分組適配器 | 繼承該類該可實(shí)現(xiàn)各種分組效果 饲窿。 |
GroupedStateRecyclerViewAdapter | 具有分組和支持狀態(tài)頁(yè)面切換的適配器,繼承GroupedRecyclerViewAdapter | 如果不需要狀態(tài)頁(yè)面焕蹄,請(qǐng)直接使用GroupedRecyclerViewAdapter逾雄。 |
BaseRecyclerViewHolder | 萬(wàn)能適配Holder | 可繼承該類擴(kuò)展功能。 |
HelperRecyclerViewHolder | 具有view快捷操作的Holder腻脏,繼承BaseRecyclerViewHolder | 此類在BaseRecyclerViewHolder基礎(chǔ)上增加了view綁定的便捷操作(推薦用法)鸦泳。 |
注:
1.主要推薦用法是 HelperRecyclerViewAdapter+HelperRecyclerViewHolder完美打造萬(wàn)能適配器,其它可根據(jù)具體需求自由選擇適配器永品。
2.類名HelpXXX開頭和GroupedXXX相關(guān)的類用方法差別較大做鹰,請(qǐng)看提供的具體demo用法
3.使用適配器時(shí)在Activity和Fragment等中不需要再創(chuàng)建一個(gè)集合用于存放數(shù)據(jù),適配器里面已經(jīng)默認(rèn)內(nèi)置裝載數(shù)據(jù)的集合List<T>
鼎姐,否則會(huì)有兩個(gè)集合占用內(nèi)存,從網(wǎng)絡(luò)返回的數(shù)據(jù)是集合可以直接丟進(jìn)適配器里面钾麸。
HelperRecyclerViewAdapter支持的數(shù)據(jù)操作接口介紹
HelperRecyclerViewAdapter是繼承于BaseRecyclerViewAdapter同時(shí)實(shí)現(xiàn)了DataHelper數(shù)據(jù)操作接口,在使用中會(huì)更加簡(jiǎn)單快捷炕桨,具體如下:
方法 | 描述 |
---|---|
void add(int position, T data); | 添加單個(gè)數(shù)據(jù)data到指定位置position |
addAll(int startPosition, List<T> datas) | 添加數(shù)據(jù)集合datas到指定位置position |
addItemToHead(T data) | 添加單個(gè)數(shù)據(jù)data到列表頭部 |
addItemsToHead(List<T> datas) | 添加數(shù)據(jù)集datas到列表頭部 |
addItemToLast(T data) | 添加單個(gè)數(shù)據(jù)data到列表尾部 |
addItemsToLast(List<T> datas) | 添加數(shù)據(jù)集合datas到列表尾部 |
alterObj(T oldData, T newData) | 將集合中的數(shù)據(jù)oldDagta修改成新數(shù)據(jù)newData |
alterObj(int index, T data) | 將index位置的數(shù)據(jù)修改成data |
** clear()** | 情空所有數(shù)據(jù) |
** contains(T data)** | 判斷集合中是否包含數(shù)據(jù)data |
** getData(int index)** | 獲取index位置的數(shù)據(jù)饭尝,return T |
isEnabled(int position) | 判斷position位置是否有效 |
remove(T data) | 移除集合中的數(shù)據(jù)data |
removeToIndex(int index) | 移除結(jié)合中index位置的數(shù)據(jù) |
removeToIndex(int index) | 移除結(jié)合中index位置的數(shù)據(jù) |
replaceAll(List<T> datas) | 替換適配器集合中所有的數(shù)據(jù) |
setListAll(List<T> datas) | 覆蓋所有數(shù)據(jù) |
注:
1.需要先調(diào)用setListAll(List<T> datas)
或者從適配器構(gòu)造方法里裝載數(shù)據(jù)后,再允許操作其它方法献宫。
2.使用以上提供的方法钥平,里面都有做空指針和索引越界判斷,外部不管集合或者數(shù)據(jù)data是否為null都可傳遞.不會(huì)導(dǎo)致應(yīng)用崩潰遵蚜。
3.使用以上所有方法有不用再調(diào)用notifyDataSetChanged()
方法刷新適配器了帖池,方法里面會(huì)自動(dòng)幫你觸發(fā)刷新通知奈惑。
萬(wàn)能適配器使用介紹
/**
* <p>描述:自定義適配器(請(qǐng)大家重點(diǎn)參考此類的使用方式和講解)</p>
*
* 一下代碼會(huì)提供四種設(shè)置數(shù)據(jù)的構(gòu)造<br/>
* 本代碼模擬采用方式四來舉例吭净,其實(shí)也是方式二的一個(gè)變種,大部分適配器都是對(duì)應(yīng)一個(gè)item布局肴甸。<br/>
* 傳統(tǒng)的寫法請(qǐng)參考:OldMyAdapter.java<br/>
* 作者: zhouyou<br>
* 日期: 2016/10/27 16:24<br>
* 版本: v2.0<br>
*/
public class MyAdapter extends HelperRecyclerViewAdapter<TestBean> {
//以下提供適配器的幾種構(gòu)造使用方式寂殉,請(qǐng)選擇自己喜歡的【一種】運(yùn)用方式就可以了
/*
//方式一 data layoutId都從外部傳入,例如:new MyAdapter(mList,this,R.layout.item)
//注意layoutIds是表示可變參數(shù)原在,支持傳入多個(gè)布局友扰,用于支持多item布局,例如:new MyAdapter(mList,this,R.layout.item庶柿,R.layout.item2)
public MyAdapter(List<TestBean> data, Context context, int... layoutIds) {
super(data, context, layoutIds);
}
//方式二 layoutIds從外部傳入村怪,例如:MyAdapter adapter = new MyAdapter(this,R.layout.item),數(shù)據(jù)傳遞用adapter.setListAll(mList);
//注意layoutIds是表示可變參數(shù),支持傳入多個(gè)布局浮庐,用于支持多item布局甚负,例如:new MyAdapter(this,R.layout.item,R.layout.item2)
public MyAdapter(Context context, int... layoutIds) {
super(context, layoutIds);
}
//方式三 數(shù)據(jù)從外部傳入,布局直接寫在里面(推薦使用方式)梭域,好處把適配器相關(guān)的item布局都放在本來中一塊管理
public MyAdapter(List<TestBean> mList, Context context) {
super(mList, context,R.layout.item);//單item布局
//super(mList, context,R.layout.item,R.layout.item2);//多item布局
}*/
//方式四 布局直接通過在構(gòu)造方法中設(shè)置(推薦使用方式)斑举,數(shù)據(jù)集合通過setListAll設(shè)置
public MyAdapter(Context context) {
super(context, R.layout.item);
}
//不需要自己再自定義viewHolder類了 庫(kù)里定義有viewHolder基類HelperRecyclerViewHolder
@Override
protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, TestBean item) {
/****1.數(shù)據(jù)獲取方式*****/
//舊:傳統(tǒng)的寫法是從集合中獲取再?gòu)?qiáng)轉(zhuǎn),如下:
//TestBean testBean =(TestBean)datas.get(position);
//新:baseadapter中提供的有獲取當(dāng)前postion位置對(duì)應(yīng)的數(shù)據(jù),直接調(diào)用就行了病涨,也不用強(qiáng)轉(zhuǎn)
final TestBean testBean = getData(position);
/****2.view賦值*****/
//方式一:采用鏈?zhǔn)降脑O(shè)計(jì)的書寫方式富玷,一點(diǎn)到尾。(方式一)
viewHolder.setText(R.id.text,testBean.getName())
.setImageResource(R.id.image, MakePicUtil.makePic(position))
/* .setVisible(R.id.text,true);//設(shè)置某個(gè)view是否可見*/
.setOnClickListener(R.id.image, new View.OnClickListener() {//點(diǎn)擊事件
@Override
public void onClick(View view) {
Toast.makeText(mContext, "我是子控件" + testBean.getName() + "請(qǐng)看我如何處理View點(diǎn)擊事件的", Toast.LENGTH_LONG).show();
}
});
//其它更多連寫功能請(qǐng)查看viewHolder類中代碼
//方式二:不采用鏈?zhǔn)降姆绞郊饶拢ㄟ^getView直接獲取控件對(duì)象轧简,不需要強(qiáng)轉(zhuǎn)了,采用的是泛型
TextView textView =viewHolder.getView(R.id.text2);
textView.setText(testBean.getAge());
/****3.其它更多使用方式勤讽,請(qǐng)自己探索*****/
//舉例如果想知道適配器中數(shù)據(jù)是否為空用isEmpty()就可以了待错,無(wú)需list.size()==0 list.isEmpty()等其它方式
if(isEmpty()){
}
}
/*******************以下兩種item點(diǎn)擊事件都可以,自己選擇合適的方式**********************************/
//方式一:此方式是另一種處理:綁定相關(guān)事件,例如點(diǎn)擊長(zhǎng)按等,默認(rèn)空實(shí)現(xiàn)会钝,如果你要使用需要覆寫setListener()方法
//方式二:綁定相關(guān)事件,例如點(diǎn)擊長(zhǎng)按等,默認(rèn)空實(shí)現(xiàn)等我們一般會(huì)在適配器外部使用伐蒋,
// 例如: mAdapter.setOnItemClickListener(new BaseRecyclerViewAdapter.OnItemClickListener<TestBean>(){});
/* @Override
protected void setListener(HelperRecyclerViewHolder viewHolder, final int position, TestBean item) {
viewHolder.getItemView().setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Toast.makeText(mContext,"我是Item:"+position,Toast.LENGTH_SHORT).show();
}
});
}*/
}
Activity/Fragment中引用:
//用框架里面的adapter時(shí)不需要再建立全局集合存放數(shù)據(jù)了,數(shù)據(jù)都和adapter綁定了迁酸,里面自帶泛型集合
//如果你外面還建立一個(gè)集合先鱼,那相當(dāng)于占用內(nèi)存兩份了。奸鬓。
List<TestBean> listData = new ArrayList<TestBean>();
//方式四對(duì)應(yīng)的初始化適配器 也可采用下面的構(gòu)造方式創(chuàng)建對(duì)象 (自己選擇)
//這種方式一定要先setAdapter然后才setListAll()設(shè)置數(shù)據(jù)
mAdapter = new MyAdapter(this);
mRecyclerView.setAdapter(mAdapter);
/****講解*****/
//1.使用setListAll(覆蓋數(shù)據(jù))后就不需要再調(diào)用notifyDataSetChanged()
//2.如果是addAll()追加
//3.自己會(huì)刷新
//4.如果集合List<TestBean>是從網(wǎng)絡(luò)請(qǐng)求中返回的焙畔,那么此處就不需要再多創(chuàng)建new ArrayList<TestBean>()操作,直接在網(wǎng)絡(luò)請(qǐng)求你成功的地方調(diào)用mAdapter.setListAll(list)串远;
mAdapter.setListAll(listData);
//方式一對(duì)應(yīng)的初始化適配器
//mAdapter = new MyAdapter(listData, this, R.layout.item);
//方式二對(duì)應(yīng)的初始化適配器
//mAdapter = new MyAdapter(this, R.layout.item);
多Item布局使用介紹
/**
* <p>描述:多item適配器</p>
*
* 作者: zhouyou<br>
* 日期: 2016/10/31 16:24<br>
* 版本: v2.0<br>
*/
public class MultiItemAdapter extends com.zhouyou.recyclerview.adapter.HelperRecyclerViewAdapter<MultipleItemBean> {
public MultiItemAdapter(Context context) {
//設(shè)置多item布局adapter_multi_item1_layout宏多,adapter_multi_item2_layout,adapter_multi_item3_layout
super(context, R.layout.adapter_multi_item1_layout,R.layout.adapter_multi_item2_layout,R.layout.adapter_multi_item3_layout);
}
@Override
protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, MultipleItemBean item) {
//方式一澡罚,對(duì)應(yīng)checkLayout中的方式一
if(item.getItemType() == 0){//adapter_multi_item1_layout布局對(duì)應(yīng)的操作
viewHolder.setText(R.id.name_tv,item.getName());
} else if(item.getItemType() == 1){//adapter_multi_item2_layout布局對(duì)應(yīng)的操作
viewHolder.setText(R.id.name_tv,item.getName())
.setText(R.id.info_tv,item.getAge());
}
/*//方式二伸但,對(duì)應(yīng)checkLayout中的方式二
int layoutType = getItemViewType(position);
if(layoutType==R.layout.adapter_multi_item1_layout){
viewHolder.setText(R.id.name_tv,item.getName());
}else if(layoutType==R.layout.adapter_multi_item2_layout){
viewHolder.setText(R.id.name_tv,item.getName())
.setText(R.id.info_tv,item.getAge());
}*/
}
/*********多item布局使用方式***********/
//如果要用多item布局,必須重寫checkLayout()方法留搔,來指定哪一條數(shù)據(jù)對(duì)應(yīng)哪個(gè)item布局文件
//不重寫的時(shí)候返回默認(rèn)是0更胖,也就是只會(huì)加載第一個(gè)布局
@Override
public int checkLayout(MultipleItemBean item, int position) {
//方式一:判斷的類型直接寫在model中
return item.getItemType();
//方式二:根據(jù)類型判斷
/*if(item instanceof A){
return R.layout.adapter_multi_item1_layout;
}else if(item instanceof B){
return R.layout.adapter_multi_item2_layout;
}else {
return R.layout.adapter_multi_item3_layout;
}*/
}
}
添加Item事件
//1.設(shè)置item事件監(jiān)聽
//2.在適配器MyAdapter類中也可以設(shè)置點(diǎn)擊事件,采用setListener()接口
mAdapter.setOnItemClickListener(new BaseRecyclerViewAdapter.OnItemClickListener<TestBean>() {
@Override
public void onItemClick(View view, TestBean item, int position) {
Toast.makeText(getApplicationContext(),"我是item "+position,Toast.LENGTH_LONG).show();
}
});
//長(zhǎng)按事件
mAdapter.setOnItemLongClickListener(new BaseRecyclerViewAdapter.OnItemLongClickListener() {
@Override
public void onItemLongClick(View view, Object item, int position) {
Toast.makeText(getApplicationContext(),"我是item長(zhǎng)按 "+position,Toast.LENGTH_LONG).show();
}
});
Item拖拽使用介紹
適配器需要繼承HelperRecyclerViewDragAdapter,同樣具備所有萬(wàn)能適配器的功能隔显。
/**
* <p>描述:item可以移動(dòng)拖拽的適配器</p>
*
*
* 作者: zhouyou<br>
* 日期: 2016/10/31 16:24<br>
* 版本: v2.0<br>
*/
public class DragAdapter extends HelperRecyclerViewDragAdapter<String> {
public DragAdapter(Context context) {
super(context, R.layout.adapter_draggable_layout);
}
@Override
protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, String item) {
viewHolder.setText(R.id.tv,item).setImageResource(R.id.image, MakePicUtil.makePic(position));
}
}
Activity/Fragment中引用:
//拖動(dòng)監(jiān)聽事件
OnItemDragListener listener = new OnItemDragListener() {
@Override
public void onItemDragStart(RecyclerView.ViewHolder viewHolder, int pos) {
//開始拖動(dòng)
}
@Override
public void onItemDragMoving(RecyclerView.ViewHolder source, int from, RecyclerView.ViewHolder target, int to) {
//拖動(dòng)中
}
@Override
public void onItemDragEnd(RecyclerView.ViewHolder viewHolder, int pos) {
//拖動(dòng)結(jié)束
}
};
DragAdapter mAdapter = new DragAdapter(this);
//適配器綁定item拖動(dòng)監(jiān)聽
ItemDragListener mItemDragAndSwipeCallback = new ItemDragListener(mAdapter);
//觸摸幫助類
ItemTouchHelper mItemTouchHelper = new ItemTouchHelper(mItemDragAndSwipeCallback);
//綁定RecyclerView
mItemTouchHelper.attachToRecyclerView(mRecyclerView);
//設(shè)置允許拖動(dòng)的方向
mItemDragAndSwipeCallback.setDragMoveFlags(ItemTouchHelper.LEFT | ItemTouchHelper.RIGHT | ItemTouchHelper.UP | ItemTouchHelper.DOWN);
//設(shè)置監(jiān)聽
mAdapter.enableDragItem(mItemTouchHelper);
mAdapter.setOnItemDragListener(listener);
//item點(diǎn)擊事件
mAdapter.setOnItemClickListener(new BaseRecyclerViewAdapter.OnItemClickListener<String>() {
@Override
public void onItemClick(View view, String item, int position) {
Toast.makeText(DragActivity.this,item,Toast.LENGTH_SHORT).show();
}
});
//設(shè)置適配器
mRecyclerView.setAdapter(mAdapter);
mAdapter.setListAll(mData);
Item動(dòng)畫使用介紹
適配器需要繼承HelperRecyclerViewAnimAdapter,同樣具備所有萬(wàn)能適配器的功能却妨。
/**
* <p>描述:具有動(dòng)畫效果的適配器</p>
*
* 作者: zhouyou<br>
* 日期: 2016/10/31 16:24<br>
* 版本: v2.0<br>
*/
public class AnimationAdapter extends HelperRecyclerViewAnimAdapter<String> {
public AnimationAdapter(Context context) {
super(context, R.layout.adapter_animation_layout);
}
@Override
protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, Object item) {
}
}
Activity/Fragment中引用:
AnimationAdapter mAdapter = new AnimationAdapter(this);
mAdapter.setShowItemAnimationEveryTime(true);//是否每次都會(huì)執(zhí)行動(dòng)畫,默認(rèn)是false,該方便測(cè)試
mAdapter.setItemAnimation(AnimationType.ALPHA);//設(shè)置item動(dòng)畫類型ALPHA、SCALE括眠、SLIDE_FROM_LEFT彪标、SLIDE_FROM_RIGHT、SLIDE_FROM_BOTTOM
//mAdapter.setCustomItemAnimator(new CustomAnimator());//自定義實(shí)現(xiàn)動(dòng)畫
//mAdapter.setItemAnimationDuration(2000);//設(shè)置動(dòng)畫執(zhí)行時(shí)間
//mAdapter.setItemAnimationInterpolator(new AccelerateInterpolator());//設(shè)置動(dòng)畫插值器
superRecyclerView.setAdapter(mAdapter);
mAdapter.setListAll(dataList);//設(shè)置數(shù)據(jù)
狀態(tài)頁(yè)面適配器介紹
狀態(tài)頁(yè)面適配器主要是解決列表頁(yè)面具有加載中頁(yè)面掷豺、空頁(yè)面捞烟、錯(cuò)誤頁(yè)面账锹、內(nèi)容頁(yè)面之間無(wú)縫切換的問題。通常的做法是用一個(gè)普通的占位頁(yè)面和Recyclerview布局平級(jí)坷襟,通過顯示和隱藏等來改變占位頁(yè)面達(dá)到效果奸柬。這里嘗試另一種方式來解決此問題,在適配器中實(shí)現(xiàn)具體的getEmptyView婴程,getErrorView廓奕,getLoadingView,雖然多了幾個(gè)方法,但是代碼更整潔清晰了档叔,也利于你想定制任意的頁(yè)面狀態(tài)桌粉,根據(jù)調(diào)用的方法動(dòng)態(tài)監(jiān)控類表的數(shù)據(jù)裝載情況才顯示出占位圖,有列表內(nèi)容顯示的時(shí)候占位圖不會(huì)被加載不會(huì)占用內(nèi)存衙四。
/**
* <p>描述:狀態(tài)頁(yè)面適配器</p>
* 1.實(shí)現(xiàn)具體的getEmptyView铃肯,getErrorView,getLoadingView,雖然多了幾個(gè)方法传蹈,但是代碼更整潔清晰了押逼,也利于你想定制任意的頁(yè)面狀態(tài)<br>
* 2.如果你的每個(gè)頁(yè)面狀態(tài)都是一樣的,不想每個(gè)頁(yè)面都去實(shí)現(xiàn)getEmptyView惦界,getErrorView挑格,getLoadingView,可以自己再封裝一個(gè)baseAdapter,處理公共的狀態(tài)頁(yè)面<br>
* 作者: zhouyou<br>
* 日期: 2018/1/19 17:51 <br>
* 版本: v1.0<br>
*/
public class EmptyStateAdapter extends HelperStateRecyclerViewAdapter<String> {
public EmptyStateAdapter(List data, Context context, int... layoutId) {
super(data, context, layoutId);
}
public EmptyStateAdapter(Context context) {
super(context, R.layout.header_footer_item);
}
//不需要自己再自定義viewHolder類了 庫(kù)里定義有viewHolder基類HelperRecyclerViewHolder
@Override
protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, String item) {
final String value = getData(position);
viewHolder.setText(R.id.test_btn, value);
}
@Override
public View getEmptyView(ViewGroup parent) {
//空頁(yè)面內(nèi)容布局
return mLInflater.inflate(R.layout.view_state_empty, parent, false);
}
@Override
public View getErrorView(ViewGroup parent) {
//錯(cuò)誤頁(yè)面布局
return mLInflater.inflate(R.layout.view_state_error, parent, false);
}
@Override
public View getLoadingView(ViewGroup parent) {
//加載中頁(yè)面布局
return mLInflater.inflate(R.layout.view_state_loading, parent, false);
}
//onBindEmptyViewHolder沾歪、onBindErrorViewHolder漂彤、onBindLoadingViewHolder根據(jù)需要進(jìn)行選擇是否實(shí)現(xiàn)。
@Override
public void onBindEmptyViewHolder(HelperRecyclerViewHolder holder) {
//修改空頁(yè)面內(nèi)容
holder.setText(R.id.tv_empty_view, "我更新了空頁(yè)面內(nèi)容");
}
/* @Override
public void onBindErrorViewHolder(HelperRecyclerViewHolder holder) {
super.onBindErrorViewHolder(holder);
}*/
/* @Override
public void onBindLoadingViewHolder(HelperRecyclerViewHolder holder) {
super.onBindLoadingViewHolder(holder);
}*/
}
在需要的地方灾搏,通過一些方法來控制頁(yè)面的顯示挫望。
mAdapter = new EmptyStateAdapter(this);
mRecyclerView.setAdapter(mAdapter);
//以下狀態(tài)在需要的地方調(diào)用
mAdapter.setState(HelperStateRecyclerViewAdapter.STATE_LOADING);//模擬加載中
//mAdapter.setState(HelperStateRecyclerViewAdapter.STATE_ERROR);
//mAdapter.setState(HelperStateRecyclerViewAdapter.STATE_EMPTY);
//如果頁(yè)面列表集合有內(nèi)容調(diào)用mAdapter.setListAll(list);時(shí)會(huì)自動(dòng)隱藏占位圖
mAdapter.setListAll(list);
//如果設(shè)置了 mAdapter.setState()調(diào)用:mAdapter.clear();/mAdapter.remove()等都會(huì)自動(dòng)切換到占位圖
//如果用網(wǎng)格Manager,必須用StateGridLayoutManager,否則Grid狀態(tài)頁(yè)面會(huì)不起作用
StateGridLayoutManager layoutManager = new StateGridLayoutManager(this,3);
//切記狂窑!切記媳板!切記!
//setLayoutManager方法一定要放在setAdapter之后蕾域,否則LayoutManager是GridLayoutManager的時(shí)候尾部腳顯示錯(cuò)誤
mRecyclerView.setLayoutManager(layoutManager);
注:
1.如果用網(wǎng)格Manager,必須用StateGridLayoutManager拷肌,否則Grid狀態(tài)頁(yè)面會(huì)不起作用
2.setLayoutManager方法一定要放在setAdapter之后到旦,否則LayoutManager是GridLayoutManager的時(shí)候尾部顯示錯(cuò)誤,切記旨巷!切記!切記添忘!
分組顯示
主要采用GroupedRecyclerViewAdapter可以很方便的實(shí)現(xiàn)RecyclerView的分組顯示采呐,并且每個(gè)組都可以包含組頭、組尾和子項(xiàng)搁骑;可以方便實(shí)現(xiàn)多種Type類型的列表斧吐,可以實(shí)現(xiàn)如QQ聯(lián)系人的列表一樣的列表展開收起功能又固,還可以實(shí)現(xiàn)頭部懸浮吸頂功能等。
示例:
public class GroupedListAdapter extends GroupedRecyclerViewAdapter<GroupBean> {
public GroupedListAdapter(Context context) {
super(context);
}
public GroupedListAdapter(Context context, List<GroupBean> list) {
super(context, list);
}
//返回組的數(shù)量
@Override
public int getGroupCount() {
return getGroups().size();
}
//返回當(dāng)前組的子項(xiàng)數(shù)量
@Override
public int getChildrenCount(int groupPosition) {
return getGroup(groupPosition).getChildren().size();
}
//當(dāng)前這個(gè)組是否有頭部
@Override
public boolean hasHeader(int groupPosition) {
return true;
}
//當(dāng)前這個(gè)組是否有尾部
@Override
public boolean hasFooter(int groupPosition) {
return true;
}
//返回頭部的布局id煤率。(如果hasHeader返回false仰冠,這個(gè)方法不會(huì)執(zhí)行)
@Override
public int getHeaderLayout(int viewType) {
return R.layout.adapter_header;
}
//返回尾部的布局id。(如果hasFooter返回false蝶糯,這個(gè)方法不會(huì)執(zhí)行)
@Override
public int getFooterLayout(int viewType) {
return R.layout.adapter_footer;
}
//返回子項(xiàng)的布局id洋只。
@Override
public int getChildLayout(int viewType) {
return R.layout.adapter_child;
}
//綁定頭部布局?jǐn)?shù)據(jù)。(如果hasHeader返回false昼捍,這個(gè)方法不會(huì)執(zhí)行)
@Override
public void onBindHeaderViewHolder(HelperRecyclerViewHolder holder, int groupPosition, GroupBean item) {
//也可以通過Group獲取
//GroupEntity entity =getGroup(groupPosition);
holder.setText(R.id.tv_header, item.getHeader());
}
//綁定尾部布局?jǐn)?shù)據(jù)识虚。(如果hasFooter返回false,這個(gè)方法不會(huì)執(zhí)行)
@Override
public void onBindFooterViewHolder(HelperRecyclerViewHolder holder, int groupPosition, GroupBean item) {
holder.setText(R.id.tv_footer, item.getFooter());
}
//綁定子項(xiàng)布局?jǐn)?shù)據(jù)妒茬。
@Override
public void onBindChildViewHolder(HelperRecyclerViewHolder holder, int groupPosition, int childPosition, GroupBean item) {
holder.setText(R.id.tv_child, item.getChildren().get(childPosition).getChild());
}
}
還可是重寫GroupedRecyclerViewAdapter方法實(shí)現(xiàn)頭担锤、尾和子項(xiàng)的多種類型item。
//返回頭部的viewType乍钻。
public int getHeaderViewType(int groupPosition);
//返回尾部的viewType肛循。
public int getFooterViewType(int groupPosition) ;
//返回子項(xiàng)的viewType。
public int getChildViewType(int groupPosition, int childPosition) ;
設(shè)置點(diǎn)擊事件的監(jiān)聽
GroupedListAdapter adapter = new GroupedListAdapter(this, GroupModel.getGroups(10, 5));
adapter.setOnHeaderClickListener(new com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter.OnHeaderClickListener<GroupBean>() {
@Override
public void onHeaderClick(com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter adapter, HelperRecyclerViewHolder holder, int groupPosition, GroupBean item) {
}
});
adapter.setOnFooterClickListener(new com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter.OnFooterClickListener<GroupBean>() {
@Override
public void onFooterClick(com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter adapter, HelperRecyclerViewHolder holder,
int groupPosition, GroupBean item) {
}
});
adapter.setOnChildClickListener(new com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter.OnChildClickListener<GroupBean>() {
@Override
public void onChildClick(com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter adapter, HelperRecyclerViewHolder holder,
int groupPosition, int childPosition, GroupBean item) {
}
});
rvList.setAdapter(adapter);
注:
1.setLayoutManager()必須放在setAdapter之前银择,切記育拨!切記!切記欢摄!
2.更多功能使用講解請(qǐng)參考本庫(kù)demo中使用示例或者參考donkingliang的github熬丧,此模塊功能是集成作者的,在此非常感謝怀挠,同時(shí)也處理了對(duì)XRecyclerview的兼容析蝴、能夠做到分組也支持刷新和加載更多,同時(shí)新增支持:追加狀態(tài)頁(yè)面的分組效果(請(qǐng)看demo)绿淋。