RecyclerView 是Android L版本中新新增的一個用來取代ListView的SDK，它的靈活性與可替代性比listview更好。RecyclerView 同樣也用到適配，枯燥重複的適配肯定會讓你不勝其煩，下面讓我們一起來打造一款通用的適配（BaseQuickAdapter）。受益群體幾乎是所有Android開發者，希望更你們能夠一起來維護這個專案，把這個專案做得更好，幫助更多人。

看到這裡你肯定會有疑問，通用適配（BaseQuickAdapter），它具體能夠做些什麼呢，或者說它都有哪些功能？

這裡非常感謝 陳宇明

本文結合他文章和我的一些修改，希望大家能夠喜歡。

一、BaseQuickAdapter 簡介

• 減少重複 Adapter 程式碼

• 新增 Item 的點選事件，長按事件以及子控制元件的點選事件

• 新增頭部、尾部，下拉重新整理、上拉載入（上拉載入的5種載入更多動畫任你選擇，後期會新增更多的載入動畫）、沒有更多資料

• 可以自定義頭部、尾部、載入更多佈局

• 新增 Item滑動動畫 （9種動畫切換，輕鬆一行程式碼）

• 新增新增、刪除 Item動畫 （目前支援預設的動畫方式）

• 網格，列表，流式隨意切換

• 新增空佈局（列表無資料時，顯示更加人性化）

• 拖拽和側滑刪除

• 支援多型別佈局

• 類似淘寶列表切換

• 字母導航

• 類似探探翻牌

看了 BaseQuickAdapter 的特性，接著來看看外面如何在專案中匯入（依賴）它。

BaseQuickAdapter 匯入（依賴）

方式一：build.gradle 的 dependencies 新增如下程式碼：

//最新程式碼還沒更新到 jcenter 倉庫，推薦使用方法二依賴專案
compile 'com.github.baserecycleradapter:library:1.1.0'

方式二：下載原始碼，新增 library 庫到你專案當中。

這裡推薦使用方法二依賴進專案。

BaseQuickAdapter 使用

mRecyclerView.setAdapter(mAdapter = new BaseQuickAdapter<String, BaseViewHolder>(R.layout.rv_item, getItemDatas()) {
    @Override
 

    protected void convert(final BaseViewHolder helper, String item) {
        helper.setText(R.id.tv_item_text, item);

    }
});     

Item點選，長按事件

//Item 點選事件
setOnItemClickListener(int viewId, AdapterView.OnItemClickListener listener)

//長按事件
setOnItemLongClickListener(int viewId, AdapterView.OnItemLongClickListener listener)

子控制元件的點選事件

   helper.setOnClickListener(R.id.tv_item_text, new View.OnClickListener() {
       @Override
       public void onClick(View v) {
          //事件處理
       }
   });

新增頭部，尾部

    //頭部
    mAdapter.addHeaderView();

    //尾部
    mAdapter.addFooterView();

以下是新增頭部的程式碼：

View headerView=getLayoutInflater().inflate(R.layout.rv_header, null);

headerView.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,ViewGroup.LayoutParams.WRAP_CONTENT));

mAdapter.addHeaderView(headerView);

部的新增與頭部的新增類似。

新增 Item動畫

 //一行程式碼開啟動畫 預設CUSTOM動畫
  mAdapter.openLoadAnimation(BaseQuickAdapter.CUSTOMIN);

當然你可以更換其他動畫：

//ALPHAIN, SCALEIN, SLIDEIN_BOTTOM, SLIDEIN_LEFT, SLIDEIN_RIGHT, //SLIDEIN_LEFT_RIGHT, SLIDEIN_BOTTOM_TOP, CUSTOMIN
mAdapter.openLoadAnimation(BaseQuickAdapter.CUSTOMIN);

最後你可以自定義 Item動畫：

mAdapter.openLoadAnimation(new BaseAnimation[]{
        new BaseAnimation() {
            @Override
            public Animator[] getAnimators(View view) {
                return new Animator[]{ObjectAnimator.ofFloat(view, "alpha", 0.5f, 1.0f),
                        ObjectAnimator.ofFloat(view, "scaleX", 0.5f, 1.0f)};
            }
        }
});

設定載入更多

只需要設定載入更多介面，就可以實現載入更多功能。

    mAdapter.setOnLoadMoreListener(new BaseQuickAdapter.RequestLoadMoreListener() {
        @Override
        public void onLoadMoreRequested() {
        }
    });

以下演示正在載入中，載入失敗點選重試，載入完成等狀態：

    mShowType++;
    if (mShowType == 2) {
        mHandler.postDelayed(new Runnable() {
            @Override
            public void run() {
                //載入失敗，點選重試
                mAdapter.loadMoreFail();
            }
        }, DELAY_MILLIS);
    } else if (mShowType >= 4) {
        mHandler.post(new Runnable() {
            @Override
            public void run() {
                //載入完成
                mAdapter.loadMoreEnd();
            }
        });
    } else {
        mHandler.postDelayed(new Runnable() {
            @Override
            public void run() {
                mAdapter.addData(addDatas());
                //載入更多完成
                mAdapter.loadMoreComplete();
            }
        }, DELAY_MILLIS);
    }

你可以設定載入更多型別，只需要新增一行程式碼，實現不同的載入更多動畫：

  //設定載入更多 loadingview 
 setLoadMoreType(@LoadMoreType int loadMoreType)

這裡有四種模式供你選擇，APAY, BALL_BEAT, BALL_CLIP_ROTATE, BALL_SCALE，如果都不滿足你的需求，你可以繼承 BaseIndicator類從新載入檢視，或給我留言。

新增空佈局

    View emptyView=getLayoutInflater().inflate(R.layout.rv_empty, null);
    emptyView.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
            ViewGroup.LayoutParams.MATCH_PARENT));
    //新增空檢視
    mAdapter.setEmptyView(emptyView);

    emptyView.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            Snackbar.make(view, "your click empty", Snackbar.LENGTH_SHORT).show();
        }
    });

拖拽和側滑

新增以下程式碼：

ItemTouchHelper.Callback callback = new SimpleItemTouchHelperCallback(mAdapter);

ItemTouchHelper mItemTouchHelper = new ItemTouchHelper(callback);

mAdapter.setItemTouchHelper(mItemTouchHelper);

mAdapter.setDragViewId(R.id.iv_drag);

mItemTouchHelper.attachToRecyclerView(mRecyclerView);

支援不同型別

mRecyclerView.setAdapter(mAdapter = new BaseMultiItemAdapter<MultiItem>(this, getMultiItemDatas()) {
    @Override
    protected void convert(BaseViewHolder helper, MultiItem item) {
        switch (helper.getItemViewType()) {
            case MultiItem.SEND:
                helper.setText(R.id.chat_from_content, item.content);
                //helper.setImageBitmap(R.id.chat_from_icon,getRoundCornerBitmap(BitmapFactory.decodeResource(getResources(), R.mipmap.chat_head), 16));
                break;
            case MultiItem.FROM:
                helper.setText(R.id.chat_send_content, item.content);
                //helper.setImageBitmap(R.id.chat_send_icon,getRoundCornerBitmap(BitmapFactory.decodeResource(getResources(), R.mipmap.from_head), 16));
                break;
        }
    }
    @Override
    protected void addItemLayout() {
        addItemType(MultiItem.SEND, R.layout.chat_send_msg);
        addItemType(MultiItem.FROM, R.layout.chat_from_msg);
    }
});
mAdapter.openLoadAnimation(true);
btnSend.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        MultiItem multiItem = new MultiItem();
        multiItem.itemType = MultiItem.SEND;
        multiItem.content = etChat.getText().toString();
        mAdapter.add(multiItem);
        mRecyclerView.smoothScrollToPosition(mAdapter.getItemCount());
        //mRecyclerView.scrollToPosition(mAdapter.getItemCount() - 1);
    }
});

資料來源：

public static List<MultiItem> getMultiItemDatas() {
    List<MultiItem> list = new ArrayList<>();
    for (int i = 0; i < 100; i++) {
        MultiItem multiItem = new MultiItem();
        if (i % 2 == 0) {
            multiItem.itemType = MultiItem.SEND;
            multiItem.content = "海，妹子約嗎";
        } else {
            multiItem.itemType = MultiItem.FROM;
            multiItem.content = "大哥，你別怕";
        }
        list.add(multiItem);
    }
    return list;
}

這樣就輕鬆實現了聊天介面。

這樣簡單的配置就可以實現多型別佈局，不需要你寫格外的程式碼。

流式佈局

先來看看效果圖：

一行程式碼實現流式佈局效果：

mRecyclerView.setLayoutManager(new FlowLayoutManager());

探探翻牌

類似流式效果，重寫 LayoutManager 實現翻牌效果：

 mRecyclerView.setLayoutManager(new OverLayCardLayoutManager());

//新增 itemTouchHelper

    final TanTanCallback callback = new TanTanCallback(mRecyclerView, mAdapter, mAdapter.getData());
    //測試豎直滑動是否已經不會被移除螢幕
    //callback.setHorizontalDeviation(Integer.MAX_VALUE);
    final ItemTouchHelper itemTouchHelper = new ItemTouchHelper(callback);
    itemTouchHelper.attachToRecyclerView(mRecyclerView);

效果圖一覽：

具體實現請參考 Demo

淘寶商品列表切換

先來看看效果圖：

看看程式碼的實現：

        //線性
        if (mIsLinearManager) {
            mAdapter.setLayoutType(BaseQuickAdapter.TRANS_0_VIEW);
            mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
        } else {
            //網格
            mAdapter.setLayoutType(BaseQuickAdapter.TRANS_1_VIEW);
            mRecyclerView.setLayoutManager(new GridLayoutManager(this, 2));
            //需要顯示載入更多則加上下面這句   從新關聯recycler
            mAdapter.onAttachedToRecyclerView(mRecyclerView);
        }
        mIsLinearManager = !mIsLinearManager;

注意：最多支援3種不同型別的轉換。

單選

實現單選，有好幾位同仁都在問我，其實實現單選是比較簡單的，方案也比較多，我這裡就不在細講了。下面我給出一種實現方案：

    public void setItemChecked(int position) {
        if (mLastCheckedPosition == position)
            return;

        mBooleanArray.put(position, true);

        if (mLastCheckedPosition > -1) {
            mBooleanArray.put(mLastCheckedPosition, false);
            mAdapter.notifyItemChanged(mLastCheckedPosition);
        }

        mAdapter.notifyDataSetChanged();

        mLastCheckedPosition = position;
    }

mBooleanArray 儲存是否被點選，把點選前的索引值置為 false , 點選索引置為 true 。

敬請大家的關注，後期會一直維護本庫，有什麼好的想法，可以提出來。我們互相學習進度。 下一個版本會自定義下拉重新整理，全新多項的重新整理貢大家喜歡。再次感謝大家一直對我的關注，新年將近，祝願大家新年新氣象，新年大吉！

原始碼傳送門

如果對你有所幫助請給star

歡迎加入478720016來幫助更多的人。