可扩展的 RecyclerView

RecyclerView 在 Android 应用程序中广泛使用，它可用于在列表、网格和瀑布流视图中显示数据。但是，当您需要显示可展开的分组列表时，它可能变得有点棘手。因此，我们需要使用可扩展的 RecyclerView。

介绍

可扩展的 RecyclerView 是一个用于 Android 应用程序的开源库，它可轻松扩展 RecyclerView 来支持分组列表。如果您的应用程序需要显示某种类型的分组数据，那么这个库是绝对值得一试的。

特点

• 轻松扩展 RecyclerView 来支持分组列表。
• 丰富的 API 对用户友好。
• 使用默认的可扩展视图保持灵活性。

安装

Gradle：

dependencies {
    implementation 'com.github.lisawray:expandable-recycler-view:1.0.3'
}

使用

使用此库，您需要创建一个类来扩展 ExpandableRecyclerViewAdapter，然后将该类与 RecyclerView 一起使用。以下是该类的示例。

class MyExpandableRecyclerViewAdapter(
    val groups: List<ExpandableGroup>,
    val onItemClickListener: OnItemClickListener // 如果需要实现 item 的点击事件，则需要传递一个实现了 OnItemClickListener 接口的类
) : ExpandableRecyclerViewAdapter<MyGroupViewHolder, MyChildViewHolder>(groups) {

    override fun onCreateGroupViewHolder(parent: ViewGroup, viewType: Int): MyGroupViewHolder {
        val view = LayoutInflater.from(parent.context).inflate(R.layout.my_group_view, parent, false)
        return MyGroupViewHolder(view)
    }

    override fun onCreateChildViewHolder(parent: ViewGroup, viewType: Int): MyChildViewHolder {
        val view = LayoutInflater.from(parent.context).inflate(R.layout.my_child_view, parent, false)
        return MyChildViewHolder(view)
    }

    override fun onBindChildViewHolder(holder: MyChildViewHolder, flatPosition: Int, group: ExpandableGroup<*>, childIndex: Int) {
        val myGroupData = (group as MyGroup).children[childIndex] as MyChild
        holder.bind(myGroupData, onItemClickListener)
    }

    override fun onBindGroupViewHolder(holder: MyGroupViewHolder, flatPosition: Int, group: ExpandableGroup<*>) {
        val myGroupData = group as MyGroup
        holder.bind(myGroupData, onItemClickListener)
    }
}

然后，您需要实现自己的 ViewHolder，用于显示列表项。

对于组的 ViewHolder，您需要继承 GroupViewHolder。

class MyGroupViewHolder(itemView: View) : GroupViewHolder(itemView) {
    // 继承 GroupViewHolder 后，可以在该 ViewHolder 中设置展开 / 折叠图标等。
    // 可以重写 expand() 和 collapse() 方法，自定义该 ViewHolder 展开 / 折叠时的动画效果。
    fun bind(myGroupData: MyGroup, onItemClickListener: OnItemClickListener) {
        // 绑定视图，如 TextView、ImageView 等
        // 在需要处理点击事件的视图上，设置监听器：
        itemView.setOnClickListener {
            if (isExpanded) {
                collapse()
            } else {
                expand()
            }
        }
    }
}

对于子项的 ViewHolder，您需要继承 ChildViewHolder。

class MyChildViewHolder(itemView: View) : ChildViewHolder(itemView) {
    fun bind(myChildData: MyChild, onItemClickListener: OnItemClickListener) {
        // 绑定视图，如 TextView、ImageView 等
        // 在需要处理点击事件的视图上，设置监听器：
        itemView.setOnClickListener {
            onItemClickListener.onItemClick(myChildData) // 调用接口方法传递子项数据，让调用方可以在点击时处理子项的点击事件。
        }
    }
}

然后，您可以像平时一样配置 RecyclerView。

val recyclerView = findViewById<RecyclerView>(R.id.my_recycler_view)
recyclerView.layoutManager = LinearLayoutManager(this)
val myGroups = listOf(MyGroup("Group1", listOf(MyChild("Child1"), MyChild("Child2"))), MyGroup("Group2", listOf(MyChild("Child3"), MyChild("Child4"))))
val adapter = MyExpandableRecyclerViewAdapter(myGroups, this) // this 要实现 OnItemClickListener 接口
recyclerView.adapter = adapter

总结

可扩展的 RecyclerView 是一个非常有用的开源库，它允许您轻松扩展 RecyclerView 来支持分组列表。这个库非常易于使用，并且提供了丰富的 API，可以满足您的需求。