一個RecyclerView實現多級摺疊列表(TreeRecyclerView)

前言

不得不吐槽一下產品. 尼瑪爲啥要搞這樣的功能.... 搞個兩級的不就行了嘛...自帶控件,多好. 三級,四級,據說還有六級的.... 這樣喪心病狂的設計,後臺也很差給數據吧.

2018年更新:

因爲迭代了不少版本,老的文章內容已經不適用,更新一下.

效果及實現代碼:

如下實現都只用一個RecycerView,沒有嵌套.

三級列表:

購物車:

分類快速定位:

綜合(頭部,側滑,定位,摺疊):

多樣式列表:

如何使用,這裏只列出摺疊的使用方法:

一.你須要建立一個adapter:

//根據item的狀態展現,可摺疊
    TreeRecyclerAdapter treeRecyclerAdapter = new TreeRecyclerAdapter(TreeRecyclerType.SHOW_EXPAND);
複製代碼

二.你須要選擇一種展開方式

public TreeRecyclerAdapter() {
        this(null);
    }

    public TreeRecyclerAdapter(TreeRecyclerType treeRecyclerType) {
        type = treeRecyclerType == null ? TreeRecyclerType.SHOW_DEFAULT : treeRecyclerType;
    }
複製代碼

構造函數傳入,不傳默認則使用SHOW_DEFAULT.

三.寫具體展現的item

注意! 使用這個,沒有寫ViewHolder的概念,只有TreeItem和TreeItemGroup

簡單的TreeItemGroup示例,第二級 市:

/**
* 城市
 */
public class CountyItemParent extends TreeItemGroup<ProvinceBean.CityBean> {//泛型表明綁定的javabean
    
    //建立子TreeItem.
    @Override
    public List<TreeItem> initChildList(ProvinceBean.CityBean data) {
        return ItemHelperFactory.createItems(data.getAreas(),  this);
    }

    //該級具體展現的Layout
    @Override
    public int getLayoutId() {
        return R.layout.item_two;
    }

    //view和data綁定
    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder) {
        holder.setText(R.id.tv_content, data.getCityName());
    }
}
複製代碼

---

簡單的TreeItem示例,第三級城市:

/**
* 縣
 */
public class AreaItem extends TreeItem<ProvinceBean.CityBean.AreasBean> {//泛型表明綁定的javabean

    //這個item的具體展現layout
    @Override
    public int getLayoutId() {
        return R.layout.item_three;
    }
    //這個Item條目的視圖綁定操做,
    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder) {
        holder.setText(R.id.tv_content, data.getAreaName());
    }
    //這個Item,在RecyclerView的每行所佔比,只有RecyclerView設置了GridLayoutManager纔會生效.
    //這個最好是返回能整出的數.之因此用除法,是爲了能夠作到,只改變GridLayoutManager的總數,無需改變Item
    @Override
    public int getSpanSize(int maxSpan) {
        return maxSpan / 6;
    }
}

複製代碼

第一級爲啥沒寫呢? 由於寫法和第二級同樣的,就不寫出來了.具體見demo

怎麼建立Item呢?

有兩種方法:

1.在javabean上使用註解:

@TreeDataType(iClass = AreaItem.class)
  public class AreasBean{
  ...
  }
複製代碼

而後重寫在TreeItemGroup中initChildList()

@Override
    public List<TreeItem> initChildList(ProvinceBean.CityBean data) {
        return ItemHelperFactory.createItems(data.getAreas(),  this);
    }

複製代碼

這樣,item就生成了.

2.直接傳入item的class,建立item

//建立item
 List<TreeItem> provinceItemList = ItemHelperFactory.createItems(cityBeen, ProvinceItemParent.class, null);
 List<TreeItem> items = ItemHelperFactory.createItems(cityBeen, null);
複製代碼

這2行代碼,效果上是同樣的.

---

四.如何更新adapter:

五,如何設置點擊:

條目點擊

1.重寫TreeItem的onClick():

2. adapter設置 setOnItemClickListener

adapter.setOnItemClickListener(new BaseRecyclerAdapter.OnItemClickListener() {
            @Override
            public void onItemClick(@NonNull ViewHolder viewHolder, int position) {
       
            }
        });
複製代碼

注意.兩者衝突

---

下面附上github地址,裏面有Demo,

傳送門:TreeRecyclerView 歡迎Star,哈哈

您的喜歡與回覆是我最大的動力,歡迎評論補充.