在Android开发中，ExpandableListView 是一种非常实用的控件，它允许用户通过分组的方式展示数据，从而提升界面的层次感和用户体验。本文将详细介绍如何在 Kotlin 中实现和使用 ExpandableListView，并提供一个完整的代码示例。
一、ExpandableListView 的基本概念
ExpandableListView 是 ListView 的扩展版本，支持嵌套结构的数据展示。它可以分为两层：组（Group） 和 子项（Child）。用户可以点击组来展开或折叠其对应的子项。
- 组（Group）：代表数据的大分类。
- 子项（Child）：属于某个组的具体条目。
二、准备工作
在开始之前，确保你的项目已经配置好 Kotlin 支持。如果尚未添加，请在 `build.gradle` 文件中添加以下依赖：
```groovy
implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
```
同时，确保你已经在布局文件中定义了一个 ExpandableListView 控件。
三、实现步骤
1. 创建数据模型
首先，我们需要定义两个类来表示组和子项的数据结构。
```kotlin
// 组数据模型
data class GroupItem(val title: String, val description: String)
// 子项数据模型
data class ChildItem(val name: String, val age: Int)
```
2. 创建适配器
ExpandableListView 需要一个自定义的适配器来绑定数据。我们可以继承 `BaseExpandableListAdapter` 并重写相关方法。
```kotlin
class MyExpandableAdapter(
private val context: Context,
private val groupList: List
private val childMap: Map
) : BaseExpandableListAdapter() {
override fun getGroupCount(): Int {
return groupList.size
}
override fun getChildCount(groupPosition: Int): Int {
return childMap[groupList[groupPosition]]?.size ?: 0
}
override fun getGroup(groupPosition: Int): Any {
return groupList[groupPosition]
}
override fun getChild(groupPosition: Int, childPosition: Int): Any {
return childMap[groupList[groupPosition]]?.get(childPosition) ?: null
}
override fun getGroupId(groupPosition: Int): Long {
return groupPosition.toLong()
}
override fun getChildId(groupPosition: Int, childPosition: Int): Long {
return childPosition.toLong()
}
override fun hasStableIds(): Boolean {
return true
}
override fun isChildSelectable(groupPosition: Int, childPosition: Int): Boolean {
return true
}
override fun getGroupView(
groupPosition: Int,
isExpanded: Boolean,
convertView: View?,
parent: ViewGroup?
): View {
val view = LayoutInflater.from(context).inflate(android.R.layout.simple_expandable_list_item_1, parent, false)
val textView = view.findViewById
textView.text = (getGroup(groupPosition) as GroupItem).title
return view
}
override fun getChildView(
groupPosition: Int,
childPosition: Int,
isLastChild: Boolean,
convertView: View?,
parent: ViewGroup?
): View {
val view = LayoutInflater.from(context).inflate(android.R.layout.simple_list_item_1, parent, false)
val textView = view.findViewById
textView.text = (getChild(groupPosition, childPosition) as ChildItem).name
return view
}
}
```
3. 初始化 ExpandableListView
在 Activity 或 Fragment 中初始化 ExpandableListView，并设置适配器。
```kotlin
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// 示例数据
val groupList = listOf(
GroupItem("Group 1", "Description 1"),
GroupItem("Group 2", "Description 2")
)
val childMap = mapOf(
groupList[0] to listOf(
ChildItem("Child 1-1", 25),
ChildItem("Child 1-2", 30)
),
groupList[1] to listOf(
ChildItem("Child 2-1", 28),
ChildItem("Child 2-2", 35)
)
)
// 获取控件
val expandableListView = findViewById
// 设置适配器
val adapter = MyExpandableAdapter(this, groupList, childMap)
expandableListView.setAdapter(adapter)
}
}
```
四、运行效果
运行程序后，你会看到一个带有分组功能的列表。点击组头时，会自动展开或折叠对应的子项。
五、注意事项
1. ExpandableListView 在 Android 11 及更高版本中已被 RecyclerView 替代，因此建议在新项目中优先考虑使用 RecyclerView 的 `GroupedRecyclerViewAdapter`。
2. 如果需要更复杂的样式，可以通过自定义布局文件替换默认的 `simple_expandable_list_item_1` 和 `simple_list_item_1`。
通过以上步骤，你可以轻松地在 Kotlin 中实现 ExpandableListView，并根据需求进一步优化。希望本文对你有所帮助！
