MagicAdapter

是一个超级轻量级的可以快速实现 RecyclerView 复杂适配器的工具库。

show.gif

特性

• 基于 Kotlin 语言
• 基于 Databinding
• 不再需要维护 Adapter，全局只有一个 MagicAdapter
• 不再需要维护 ViewHolder
• 支持多条目类型
• 提供了一些基本回调
• 轻松扩展 Header 和 Footer
• 轻松扩展 RecycleView 动画和事件
• 没有反射，效率很高
• 超级轻量，不足 34 KB
• 最小兼容 Android SDK : 14

集成

1.在 root's build.gradle 中加入 jcenter 仓库

allprojects {
    repositories {
        ...
        jcenter()
    }
}

2.在 app's build.gradle 中开启 databinding

android {
    ...
    dataBinding {
        enabled = true
    }
}

3.在 app's build.gradle 中添加依赖(请使用最新版本)

dependencies {
    ...
    implementation 'com.xuyefeng:magicadapter:1.0.3'
}

使用

1.创建 RecyclerView item 布局文件 image_item_layout.xml

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">

    <data>

        <variable
            name="item"
            type="com.blue.helloadapter.ImageItem" />
    </data>

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_margin="10dp">

        <ImageView
            android:id="@+id/iv"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true" />
    </RelativeLayout>
</layout>

请注意这里的声明的 XXXItem 的 name 必须为 item

2.创建 item 布局文件对应的 XXXItem 即 ImageItem

class ImageItem(
        val resId: Int
) : BaseItem() {

    override fun getLayout(): Int = R.layout.image_item_layout

    override fun onBinding(holder: ItemViewHolder) {
        (binding as ImageItemLayoutBinding).apply {
            iv.setImageResource(resId)
            iv.setOnClickListener {
                Toast.makeText(iv.context, "click image on ${holder.adapterPosition}", Toast.LENGTH_SHORT).show()
            }
        }
    }
}

这里针对 BaseItem 说明一下：

• 可以拿到 RecyclerView 绑定的 Adapter
• 可以拿到 item 对应的 ViewHolder
• 可以拿到 item 对应的 Databinding

3.用同样的方法创建 TextItem 和 ButtonItem，接下来就可以添加数据了

val adapter = MagicAdapter()
adapter.addItem(ImageItem(R.drawable.s1))
adapter.addItem(TextItem())
adapter.addItem(ButtonItem())
recyclerView.adapter = adapter

4.如果你需要回调，可以像这样

adapter.itemClick = {
    val position = it.adapterPosition
    val item = it.item
    val binding = it.binding
    ...
}
adapter.itemLongClick = {
    ...
}
adapter.viewAttached = {
    ...
}
adapter.viewDetached = {
    ...
}

到这里就结束了，为一个 RecyclerView 添加复杂适配器原来可以如此简单。
最后再附上：github地址传送门 喜欢就star一下呗