基于RecyclerView的刷新庫(kù)終極封裝(三)

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)绿淋。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末闷畸,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子吞滞,更是在濱河造成了極大的恐慌佑菩,老刑警劉巖,帶你破解...
    沈念sama閱讀 206,311評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件裁赠,死亡現(xiàn)場(chǎng)離奇詭異殿漠,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)佩捞,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,339評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門绞幌,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人一忱,你說我怎么就攤上這事莲蜘√啡罚” “怎么了?”我有些...
    開封第一講書人閱讀 152,671評(píng)論 0 342
  • 文/不壞的土叔 我叫張陵票渠,是天一觀的道長(zhǎng)逐哈。 經(jīng)常有香客問我,道長(zhǎng)问顷,這世上最難降的妖魔是什么鞠眉? 我笑而不...
    開封第一講書人閱讀 55,252評(píng)論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮择诈,結(jié)果婚禮上械蹋,老公的妹妹穿的比我還像新娘。我一直安慰自己羞芍,他們只是感情好哗戈,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,253評(píng)論 5 371
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著荷科,像睡著了一般唯咬。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上畏浆,一...
    開封第一講書人閱讀 49,031評(píng)論 1 285
  • 那天胆胰,我揣著相機(jī)與錄音,去河邊找鬼刻获。 笑死蜀涨,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的蝎毡。 我是一名探鬼主播厚柳,決...
    沈念sama閱讀 38,340評(píng)論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼沐兵!你這毒婦竟也來了别垮?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 36,973評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤扎谎,失蹤者是張志新(化名)和其女友劉穎碳想,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體毁靶,經(jīng)...
    沈念sama閱讀 43,466評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡胧奔,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,937評(píng)論 2 323
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了老充。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片葡盗。...
    茶點(diǎn)故事閱讀 38,039評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖啡浊,靈堂內(nèi)的尸體忽然破棺而出觅够,到底是詐尸還是另有隱情,我是刑警寧澤巷嚣,帶...
    沈念sama閱讀 33,701評(píng)論 4 323
  • 正文 年R本政府宣布喘先,位于F島的核電站,受9級(jí)特大地震影響廷粒,放射性物質(zhì)發(fā)生泄漏窘拯。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,254評(píng)論 3 307
  • 文/蒙蒙 一坝茎、第九天 我趴在偏房一處隱蔽的房頂上張望涤姊。 院中可真熱鬧,春花似錦嗤放、人聲如沸思喊。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,259評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)恨课。三九已至,卻和暖如春岳服,著一層夾襖步出監(jiān)牢的瞬間剂公,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,485評(píng)論 1 262
  • 我被黑心中介騙來泰國(guó)打工吊宋, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留纲辽,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 45,497評(píng)論 2 354
  • 正文 我出身青樓璃搜,卻偏偏與公主長(zhǎng)得像文兑,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子腺劣,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,786評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容