Android ExpandableListView摺疊菜單的三層嵌套實現

前段時間項目的新功能裏有些頁面須要三層嵌套列表實現，雖然在移動端這種很醜，可是需求就是需求。
原本想用各類 View 嵌套，而後發現系統有個 ExpandableListView。就直接拿來用了。html

理論上來講，ExpandableListView 的二級嵌套和三級嵌套沒有本質區別，若是把二級嵌套的子級換成一個新的 ExpandableListView，就能夠實現三級嵌套。java

有了思路，關於 ExpandableListView 的三層嵌套就直接上手實現android

這裏說下個人需求是有些數據是隻有二級，有些數據是三級的。若是你的需求是隻有三級，不須要考慮三級二級混合的狀況，下面有說明怎麼處理。git

效果圖
github

ExpandableListView

ExpandableListView 是官方提供的一個可展現摺疊列表的控件。官方文檔直鏈markdown

它的基本用法以下app

基本用法

ExpandableListView 的基本用法很簡單，它本質上就是 ListView，因此用法也差很少，這裏就不介紹了。
ide

若是有須要的，能夠參考菜鳥教程 ExpandableListView 基本用法
下面開始進入正題。oop

佈局文件

先說下，由於是三級嵌套，因此須要四個佈局文件，Activity 頁面自己須要一個佈局文件，而後就是三級嵌套的三個佈局文件。佈局

Activity 佈局文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent">
    <ExpandableListView
            android:id="@+id/expand_view"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:cacheColorHint="#00000000"
            android:childIndicator="@color/white"
            android:divider="@null"
            android:fadeScrollbars="false"
            android:groupIndicator="@null"
            android:listSelector="#00000000"
            android:scrollbars="none" />
</LinearLayout>

複製代碼

咱們能夠經過 ExpandableListView 的默認屬性來控制部分樣式，這裏貼上菜鳥教程的屬性圖片

一級菜單佈局文件

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="44dp"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:background="@drawable/chapter_gradient_group">

    <TextView
        android:id="@+id/adapter_title"
        android:layout_width="0dp"
        android:layout_height="match_parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        android:layout_marginHorizontal="10dp"
        android:paddingStart="20dp"
        android:singleLine="true"
        android:ellipsize="end"
        android:text="@string/groupName"
        android:textColor="@color/white"
        android:textSize="16sp"
        android:gravity="start|center_vertical" />

</androidx.constraintlayout.widget.ConstraintLayout>

複製代碼

二級菜單佈局文件

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/chapter_gradient_child">

    <TextView
        android:id="@+id/adapter_child_title"
        android:layout_width="match_parent"
        android:layout_height="40dp"
        android:ellipsize="end"
        android:gravity="start|center_vertical"
        android:paddingStart="30dp"
        android:paddingEnd="10dp"
        android:singleLine="true"
        android:text="@string/childName"
        android:textColor="@color/white"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

複製代碼

三級菜單佈局文件

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/chapter_gradient_grandson">

    <TextView
        android:id="@+id/adapter_grandson_title"
        android:layout_width="match_parent"
        android:layout_height="40dp"
        android:ellipsize="end"
        android:gravity="start|center_vertical"
        android:paddingStart="40dp"
        android:paddingEnd="10dp"
        android:singleLine="true"
        android:text="@string/grandsonName"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

複製代碼

Adapter

上面說過 ExpandableListView 繼承自 ListView，因此咱們須要 Adapter，三級嵌套，咱們須要兩個 Adapter。

這裏有必要說一下，爲何是兩個 Adapter，ExpandableListView 的 Adapter 繼承自 BaseExpandableListAdapter。須要重寫 getGroupView 和 getChildView。這兩個方法中的 view 分別 inflate 父級菜單的佈局和子級菜單的佈局文件。

因此咱們上面的三個級別的菜單佈局文件經過兩個 Adapter 來鏈接。分別是一級菜單的 Adapter 和三級菜單的 Adapter。

下面給出這兩個 Adapter 的詳細說明，須要注意的地方已經進行備註，請仔細看備註

一級菜單 Adapter
最值得注意的是該 Adapter 的 getChildView 方法和 getChildrenCount。由於有些數據不包含三級菜單，有些包含了三級菜單。另外，這個地方須要對下級嵌套的 ExpandableListView 進行處理。

/**
 * 三級摺疊菜單的一級Adapter
 *
 * @author StarryRivers
 */
public class ChapterExpandableAdapter extends BaseExpandableListAdapter {
    
    ...

    @Override
    public int getGroupCount() {
        // 父菜單長度
        return fatherChapterList.size();
    }

    @Override
    public int getChildrenCount(int groupPosition) {
        // 子菜單長度，嵌套因此返回只能1
        return 1;
    }

    @Override
    public View getGroupView(int groupPosition, boolean isExpanded, View convertView, ViewGroup parent) {
        GroupViewHolder groupHolder;
        // 儘量重用舊view處理
        if (convertView == null) {
            convertView = LayoutInflater.from(parent.getContext()).inflate(R.layout.adapter_expandable_group_view, parent, false);
            groupHolder = new GroupViewHolder();
            groupHolder.groupTitle = convertView.findViewById(R.id.adapter_title);
            convertView.setTag(groupHolder);
        } else {
            groupHolder = (GroupViewHolder) convertView.getTag();
        }
        // 設置title
        groupHolder.groupTitle.setText(fatherChapterList.get(groupPosition).getName());
        return convertView;
    }

    @Override
    public View getChildView(int groupPosition, int childPosition, boolean isLastChild, View convertView, ViewGroup parent) {
        if (convertView == null) {
            convertView = new CustomExpandableListView(context);
        }
        CustomExpandableListView expandableListView = (CustomExpandableListView) convertView;
        // 加載子級Adapter
        ChapterExpandableLowAdapter lowAdapter = new ChapterExpandableLowAdapter(context);
        lowAdapter.setTotalList(fatherChapterList.get(groupPosition).getSec());
        expandableListView.setAdapter(lowAdapter);
       
        if (fatherChapterList.get(groupPosition).getSec().get(childPosition).getThird().size() == 0) {
            expandableListView.setGroupIndicator(null);
        }
        // 自己的父級，至關於三級目錄的子級監聽
        expandableListView.setOnGroupClickListener((parent12, v, groupPosition12, id) -> {
            // 若是第三層size爲0，意味着沒有三級菜單
            if (fatherChapterList != null && fatherChapterList.size() > 0 && fatherChapterList.get(groupPosition).getSec().get(groupPosition12).getThird().size() == 0) {
                // TODO 業務處理
            }
            // 存在第三級數據，事件分發機制繼續想下傳遞
            return false;
        });
        expandableListView.setOnChildClickListener((parent1, v, groupPosition1, childPosition1, id) -> {
            // 三級菜單的業務處理
            return true;
        });
        return expandableListView;
    }

    /**
     * 子列表是否可選，若是爲false，則子項不能觸發點擊事件，默認爲false
     *
     * @param groupPosition groupPosition
     * @param childPosition childPosition
     * @return result
     */
    @Override
    public boolean isChildSelectable(int groupPosition, int childPosition) {
        return true;
    }

    /**
     * 父級菜單的ViewHolder
     */
    static class GroupViewHolder {
        TextView groupTitle;
    }
}


複製代碼

三級菜單 Adapter
三級菜單的 Adapter 就和普通的二級嵌套時的 Adapter 相同，沒什麼特別注意的地方，因此只列出了 getGroupView 和 getChildView 方法代碼

@Override
    public View getGroupView(int groupPosition, boolean isExpanded, View convertView, ViewGroup parent) {
        ChapterExpandableLowAdapter.GroupViewHolder groupHolder;
        // 儘量重用舊view處理
        if (convertView == null) {
            convertView = LayoutInflater.from(parent.getContext()).inflate(R.layout.adapter_expandable_child_view, parent, false);
            groupHolder = new ChapterExpandableLowAdapter.GroupViewHolder();
            groupHolder.groupTitle = convertView.findViewById(R.id.adapter_child_title);
            convertView.setTag(groupHolder);
        } else {
            groupHolder = (ChapterExpandableLowAdapter.GroupViewHolder) convertView.getTag();
        }
        // 設置title
        groupHolder.groupTitle.setText(childChapterList.get(groupPosition).getName());

        return convertView;
    }

    @Override
    public View getChildView(int groupPosition, int childPosition, boolean isLastChild, View convertView, ViewGroup parent) {
        ChapterExpandableLowAdapter.ChildViewHolder childHolder;
        if (convertView == null) {
            convertView = LayoutInflater.from(parent.getContext()).inflate(R.layout.adapter_expandable_grandson_view, parent, false);
            childHolder = new ChapterExpandableLowAdapter.ChildViewHolder();
            childHolder.childTitle = convertView.findViewById(R.id.adapter_grandson_title);
            convertView.setTag(childHolder);
        } else {
            childHolder = (ChapterExpandableLowAdapter.ChildViewHolder) convertView.getTag();
        }
        if (childChapterList.get(groupPosition).getThird() != null && childChapterList.get(groupPosition).getThird().size() > 0) {
            childHolder.childTitle.setText(childChapterList.get(groupPosition).getThird().get(childPosition).getName());
        }
        return convertView;
    }

複製代碼

使用

當咱們完成了上面的步驟以後，最後就是在 Activity 中的使用了。使用方法超級簡單

給 ExpandableListView 設置 Adapter 就能夠了

@BindView(R.id.chapter_elv)
    ExpandableListView chapterExpandable;
    private ChapterExpandableAdapter chapterExpandableAdapter;
    
    ...
    
	chapterExpandableAdapter = new ChapterExpandableAdapter(this);
    chapterExpandable.setAdapter(chapterExpandableAdapter);

複製代碼

寫在最後

哦，忘記了，由於是三級嵌套，因此 ExpandableListView 須要重寫一下，從新繪製高度。否則會出現頁面展現不全或者不完整的問題。

完整代碼在 Git，感興趣能夠看下，配合 Star 食用更香！