Android ExpandableListView用法示例详解

曦灬嫒

引言

1. 在 Android 开发中，列表展示是一种非常常见的交互形式。而 ExpandableListView 作为一种特殊的列表控件，它允许我们创建具有分组功能的列表，每个分组下还可以包含多个子项，并且分组可以展开和收缩，这大大增强了数据展示的灵活性和可读性。本文将详细介绍 ExpandableListView 的用法，从基本概念到具体实现，再到高级应用，帮助你全面掌握这一控件。

复制代码

1. ExpandableListView 基本概念

ExpandableListView 继承自 ListView，是 Android 提供的一种可展开的列表视图。它主要由分组（Group）和子项（Child）两部分组成。每个分组可以包含多个子项，用户可以通过点击分组来展开或收缩其对应的子项列表。这种控件适用于需要对数据进行分类展示的场景，例如联系人列表按照字母分组、商品列表按照类别分组等。

2. 布局文件中添加 ExpandableListView

首先，我们需要在布局文件中添加 ExpandableListView 控件。以下是一个简单的示例：

1. <!-- activity_main.xml -->
   
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   
3.     android:layout_width="match_parent"
   
4.     android:layout_height="match_parent"
   
5.     android:orientation="vertical">
   
6.     <ExpandableListView
   
7.         android:id="@+id/expandableListView"
   
8.         android:layout_width="match_parent"
   
9.         android:layout_height="match_parent" />
   
10. </LinearLayout>

复制代码

在这个布局中，我们创建了一个垂直的线性布局，并在其中添加了一个 ExpandableListView，其宽度和高度都设置为 match_parent，以填充整个父布局。

3. 创建数据模型

为了展示分组和子项的数据，我们需要创建相应的数据模型类。假设我们要展示一个水果分类列表，每个分类下有不同的水果，我们可以创建如下的数据模型类：

1. // GroupModel.java
   
2. public class GroupModel {
   
3.     private String groupName;
   
4.     public GroupModel(String groupName) {
   
5.         this.groupName = groupName;
   
6.     }
   
7.     public String getGroupName() {
   
8.         return groupName;
   
9.     }
   
10.     public void setGroupName(String groupName) {
    
11.         this.groupName = groupName;
    
12.     }
    
13. }
    
14. // ChildModel.java
    
15. public class ChildModel {
    
16.     private String childName;
    
17.     public ChildModel(String childName) {
    
18.         this.childName = childName;
    
19.     }
    
20.     public String getChildName() {
    
21.         return childName;
    
22.     }
    
23.     public void setChildName(String childName) {
    
24.         this.childName = childName;
    
25.     }
    
26. }

复制代码

GroupModel 类用于表示分组信息，包含一个分组名称；ChildModel 类用于表示子项信息，包含一个子项名称。

4. 创建适配器

ExpandableListView 需要使用适配器来将数据绑定到视图上。我们可以继承 BaseExpandableListAdapter 类来创建自定义适配器。以下是一个示例：

1. import android.content.Context;
   
2. import android.view.LayoutInflater;
   
3. import android.view.View;
   
4. import android.view.ViewGroup;
   
5. import android.widget.BaseExpandableListAdapter;
   
6. import android.widget.TextView;
   
7. import java.util.List;
   
8. public class MyExpandableListAdapter extends BaseExpandableListAdapter {
   
9.     private Context context;
   
10.     private List<GroupModel> groupList;
    
11.     private List<List<ChildModel>> childList;
    
12.     public MyExpandableListAdapter(Context context, List<GroupModel> groupList, List<List<ChildModel>> childList) {
    
13.         this.context = context;
    
14.         this.groupList = groupList;
    
15.         this.childList = childList;
    
16.     }
    
17.     @Override
    
18.     public int getGroupCount() {
    
19.         return groupList.size();
    
20.     }
    
21.     @Override
    
22.     public int getChildrenCount(int groupPosition) {
    
23.         return childList.get(groupPosition).size();
    
24.     }
    
25.     @Override
    
26.     public Object getGroup(int groupPosition) {
    
27.         return groupList.get(groupPosition);
    
28.     }
    
29.     @Override
    
30.     public Object getChild(int groupPosition, int childPosition) {
    
31.         return childList.get(groupPosition).get(childPosition);
    
32.     }
    
33.     @Override
    
34.     public long getGroupId(int groupPosition) {
    
35.         return groupPosition;
    
36.     }
    
37.     @Override
    
38.     public long getChildId(int groupPosition, int childPosition) {
    
39.         return childPosition;
    
40.     }
    
41.     @Override
    
42.     public boolean hasStableIds() {
    
43.         return false;
    
44.     }
    
45.     @Override
    
46.     public View getGroupView(int groupPosition, boolean isExpanded, View convertView, ViewGroup parent) {
    
47.         GroupModel groupModel = (GroupModel) getGroup(groupPosition);
    
48.         if (convertView == null) {
    
49.             LayoutInflater inflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    
50.             convertView = inflater.inflate(android.R.layout.simple_expandable_list_item_1, null);
    
51.         }
    
52.         TextView groupTextView = convertView.findViewById(android.R.id.text1);
    
53.         groupTextView.setText(groupModel.getGroupName());
    
54.         return convertView;
    
55.     }
    
56.     @Override
    
57.     public View getChildView(int groupPosition, int childPosition, boolean isLastChild, View convertView, ViewGroup parent) {
    
58.         ChildModel childModel = (ChildModel) getChild(groupPosition, childPosition);
    
59.         if (convertView == null) {
    
60.             LayoutInflater inflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    
61.             convertView = inflater.inflate(android.R.layout.simple_list_item_1, null);
    
62.         }
    
63.         TextView childTextView = convertView.findViewById(android.R.id.text1);
    
64.         childTextView.setText(childModel.getChildName());
    
65.         return convertView;
    
66.     }
    
67.     @Override
    
68.     public boolean isChildSelectable(int groupPosition, int childPosition) {
    
69.         return true;
    
70.     }
    
71. }

复制代码

在这个适配器中，我们需要实现一系列的方法：

• getGroupCount()：返回分组的数量。
  
• getChildrenCount(int groupPosition)：返回指定分组下子项的数量。
  
• getGroup(int groupPosition)：返回指定位置的分组对象。
  
• getChild(int groupPosition, int childPosition)：返回指定分组下指定位置的子项对象。
  
• getGroupId(int groupPosition) 和 getChildId(int groupPosition, int childPosition)：分别返回分组和子项的 ID。
  
• getGroupView(int groupPosition, boolean isExpanded, View convertView, ViewGroup parent)：创建并返回分组的视图。
  
• getChildView(int groupPosition, int childPosition, boolean isLastChild, View convertView, ViewGroup parent)：创建并返回子项的视图。
  
• isChildSelectable(int groupPosition, int childPosition)：指定子项是否可以被选中。
  

5. 在 Activity 中使用 ExpandableListView

在 Activity 中，我们需要初始化数据、创建适配器并将其设置给 ExpandableListView。以下是示例代码：

1. import android.os.Bundle;
   
2. import android.widget.ExpandableListView;
   
3. import androidx.appcompat.app.AppCompatActivity;
   
4. import java.util.ArrayList;
   
5. import java.util.List;
   
6. public class MainActivity extends AppCompatActivity {
   
7.     private ExpandableListView expandableListView;
   
8.     private MyExpandableListAdapter adapter;
   
9.     private List<GroupModel> groupList;
   
10.     private List<List<ChildModel>> childList;
    
11.     @Override
    
12.     protected void onCreate(Bundle savedInstanceState) {
    
13.         super.onCreate(savedInstanceState);
    
14.         setContentView(R.layout.activity_main);
    
15.         expandableListView = findViewById(R.id.expandableListView);
    
16.         // 初始化数据
    
17.         initData();
    
18.         // 创建适配器
    
19.         adapter = new MyExpandableListAdapter(this, groupList, childList);
    
20.         // 设置适配器
    
21.         expandableListView.setAdapter(adapter);
    
22.     }
    
23.     private void initData() {
    
24.         groupList = new ArrayList<>();
    
25.         childList = new ArrayList<>();
    
26.         // 添加分组数据
    
27.         GroupModel group1 = new GroupModel("热带水果");
    
28.         GroupModel group2 = new GroupModel("温带水果");
    
29.         groupList.add(group1);
    
30.         groupList.add(group2);
    
31.         // 为每个分组添加子项数据
    
32.         List<ChildModel> childList1 = new ArrayList<>();
    
33.         childList1.add(new ChildModel("香蕉"));
    
34.         childList1.add(new ChildModel("芒果"));
    
35.         childList.add(childList1);
    
36.         List<ChildModel> childList2 = new ArrayList<>();
    
37.         childList2.add(new ChildModel("苹果"));
    
38.         childList2.add(new ChildModel("梨"));
    
39.         childList.add(childList2);
    
40.     }
    
41. }

复制代码

在 onCreate 方法中，我们首先获取 ExpandableListView 控件的引用，然后调用 initData 方法初始化数据，接着创建适配器并将其设置给 ExpandableListView。

6. 处理分组和子项的点击事件

我们可以为 ExpandableListView 添加分组和子项的点击事件监听器，以实现相应的交互逻辑。以下是示例代码：

1. // 在 onCreate 方法中添加以下代码
   
2. expandableListView.setOnGroupClickListener(new ExpandableListView.OnGroupClickListener() {
   
3.     @Override
   
4.     public boolean onGroupClick(ExpandableListView parent, View v, int groupPosition, long id) {
   
5.         // 处理分组点击事件
   
6.         GroupModel groupModel = (GroupModel) adapter.getGroup(groupPosition);
   
7.         String groupName = groupModel.getGroupName();
   
8.         // 这里可以添加自定义的逻辑，比如弹出提示框显示分组名称
   
9.         return false;
   
10.     }
    
11. });
    
12. expandableListView.setOnChildClickListener(new ExpandableListView.OnChildClickListener() {
    
13.     @Override
    
14.     public boolean onChildClick(ExpandableListView parent, View v, int groupPosition, int childPosition, long id) {
    
15.         // 处理子项点击事件
    
16.         ChildModel childModel = (ChildModel) adapter.getChild(groupPosition, childPosition);
    
17.         String childName = childModel.getChildName();
    
18.         // 这里可以添加自定义的逻辑，比如跳转到详情页面
    
19.         return false;
    
20.     }
    
21. });

复制代码

在分组点击事件监听器中，我们可以获取点击的分组对象并进行相应的处理；在子项点击事件监听器中，我们可以获取点击的子项对象并进行相应的处理。

7. 高级应用：自定义视图

除了使用系统提供的简单布局，我们还可以自定义分组和子项的视图，以实现更丰富的界面效果。以下是一个自定义视图的示例：
自定义分组布局文件 group_item.xml

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   
2.     android:layout_width="match_parent"
   
3.     android:layout_height="wrap_content"
   
4.     android:orientation="horizontal"
   
5.     android:padding="10dp">
   
6.     <ImageView
   
7.         android:id="@+id/group_icon"
   
8.         android:layout_width="24dp"
   
9.         android:layout_height="24dp"
   
10.         android:src="@mipmap/ic_launcher" />
    
11.     <TextView
    
12.         android:id="@+id/group_name"
    
13.         android:layout_width="wrap_content"
    
14.         android:layout_height="wrap_content"
    
15.         android:layout_marginLeft="10dp"
    
16.         android:textSize="18sp" />
    
17. </LinearLayout>

复制代码

自定义子项布局文件 child_item.xml

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   
2.     android:layout_width="match_parent"
   
3.     android:layout_height="wrap_content"
   
4.     android:orientation="horizontal"
   
5.     android:padding="10dp">
   
6.     <ImageView
   
7.         android:id="@+id/child_icon"
   
8.         android:layout_width="24dp"
   
9.         android:layout_height="24dp"
   
10.         android:src="@mipmap/ic_launcher" />
    
11.     <TextView
    
12.         android:id="@+id/child_name"
    
13.         android:layout_width="wrap_content"
    
14.         android:layout_height="wrap_content"
    
15.         android:layout_marginLeft="10dp"
    
16.         android:textSize="16sp" />
    
17. </LinearLayout>

复制代码

修改适配器中的 getGroupView 和 getChildView 方法

1. @Override
   
2. public View getGroupView(int groupPosition, boolean isExpanded, View convertView, ViewGroup parent) {
   
3.     GroupModel groupModel = (GroupModel) getGroup(groupPosition);
   
4.     if (convertView == null) {
   
5.         LayoutInflater inflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
   
6.         convertView = inflater.inflate(R.layout.group_item, null);
   
7.     }
   
8.     ImageView groupIcon = convertView.findViewById(R.id.group_icon);
   
9.     TextView groupTextView = convertView.findViewById(R.id.group_name);
   
10.     groupTextView.setText(groupModel.getGroupName());
    
11.     return convertView;
    
12. }
    
13. @Override
    
14. public View getChildView(int groupPosition, int childPosition, boolean isLastChild, View convertView, ViewGroup parent) {
    
15.     ChildModel childModel = (ChildModel) getChild(groupPosition, childPosition);
    
16.     if (convertView == null) {
    
17.         LayoutInflater inflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    
18.         convertView = inflater.inflate(R.layout.child_item, null);
    
19.     }
    
20.     ImageView childIcon = convertView.findViewById(R.id.child_icon);
    
21.     TextView childTextView = convertView.findViewById(R.id.child_name);
    
22.     childTextView.setText(childModel.getChildName());
    
23.     return convertView;
    
24. }

复制代码

通过自定义视图，我们可以在分组和子项中添加更多的控件，如图片、按钮等，从而实现更复杂的界面效果。

8. 总结

ExpandableListView 是 Android 中一个非常实用的列表控件，它可以帮助我们实现具有分组功能的列表展示。通过本文的介绍，你应该已经掌握了 ExpandableListView 的基本用法，包括布局文件的添加、数据模型的创建、适配器的实现、点击事件的处理以及自定义视图的应用。在实际开发中，你可以根据具体需求对其进行进一步的扩展和优化，以满足不同的业务场景。希望本文对你有所帮助，祝你在 Android 开发中取得更好的成果！

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！