Android中ExpandableListView用法详解

来源：聚合数据类型：技术文章发布：2025-07-18 16:16:59

在 Android 开发中，ExpandableListView 是一个非常实用的控件，用于展示具有层级结构的数据。它允许用户展开或折叠列表项，从而实现更复杂的 UI 交互。相比普通的 ListView，ExpandableListView 能够在一个界面上展示多级数据，适用于如设置菜单、分类目录等场景。

本文将详细讲解 ExpandableListView 的使用方法，包括其基本概念、布局结构、适配器的创建、数据绑定以及常见操作。通过本文的学习，开发者可以掌握如何在 Android 应用中灵活运用 ExpandableListView 来构建层次分明的用户界面。

一、ExpandableListView 的基本概念

ExpandableListView 是 Android 提供的一个可扩展的列表视图组件，继承自 AbsListView。它支持两种类型的条目：组（Group）和子项（Child）。每个组可以包含多个子项，并且用户可以通过点击组来展开或折叠其子项。

组与子项的关系

组（Group）：是列表中的主项，通常代表一个分类或大标题。

子项（Child）：是组下的具体条目，可以被展开显示。

例如，在一个“音乐播放列表”应用中，“歌手”可以作为组，而“歌曲”则是子项。

布局结构

ExpandableListView 的布局通常由两个部分组成：

组布局（Group Layout）：定义了组项的外观；

子项布局（Child Layout）：定义了子项的外观。

开发者需要分别编写这两个布局文件，并在适配器中进行绑定。

二、ExpandableListView 的使用步骤

要正确使用 ExpandableListView，需要按照以下步骤进行设置：

添加布局文件

首先，在 XML 文件中添加 ExpandableListView 控件：

<ExpandableListView
    android:id="@+id/expandableListView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

创建数据模型

为了存储组和子项的数据，通常需要创建一个数据模型类，例如：

public class GroupItem {
    public String title;
    public List<String> children;
    public GroupItem(String title, List<String> children) {
        this.title = title;
        this.children = children;
    }
}

创建适配器

ExpandableListView 需要一个 BaseExpandableListAdapter 或其子类来绑定数据。以下是创建适配器的基本步骤：

实现 getGroupCount()：返回组的数量；

实现 getChildrenCount(int groupPosition)：返回某个组下的子项数量；

实现 getGroupView(int groupPosition, boolean isExpanded, View convertView, ViewGroup parent)：绑定组视图；

实现 getChildView(int groupPosition, int childPosition, boolean isLastChild, View convertView, ViewGroup parent)：绑定子项视图；

实现 getGroupId(int groupPosition) 和 getChildId(int groupPosition, int childPosition)：返回组和子项的唯一 ID；

实现 hasStableIds()：返回是否为每个组和子项分配稳定的 ID。

设置适配器

在 Activity 或 Fragment 中获取 ExpandableListView 并设置适配器：

ExpandableListView expandableListView = findViewById(R.id.expandableListView);
MyExpandableAdapter adapter = new MyExpandableAdapter(groupData);
expandableListView.setAdapter(adapter);

三、ExpandableListView 的常用操作

展开与折叠

可以通过调用 expandGroup(int groupPosition) 和 collapseGroup(int groupPosition) 方法控制组的展开与折叠状态。

expandableListView.expandGroup(0); // 展开第一个组
expandableListView.collapseGroup(0); // 折叠第一个组

点击事件处理

ExpandableListView 提供了 OnGroupClickListener 和 OnChildClickListener 接口，用于监听用户对组或子项的点击事件。

expandableListView.setOnGroupClickListener(new ExpandableListView.OnGroupClickListener() {
    @Override
    public boolean onGroupClick(ExpandableListView parent, View v, int groupPosition, long id) {
        // 处理组点击事件
        return false; // 返回 false 表示允许默认行为
    }
});
expandableListView.setOnChildClickListener(new ExpandableListView.OnChildClickListener() {
    @Override
    public boolean onChildClick(ExpandableListView parent, View v, int groupPosition, int childPosition, long id) {
        // 处理子项点击事件
        return false; // 返回 false 表示允许默认行为
    }
});