MagicAdapter

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

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.1'
}

使用

1.创建 RecycleView 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(binding: ViewDataBinding) {
        (binding as ImageItemLayoutBinding).apply {
            iv.setImageResource(resId)
            iv.setOnClickListener {
                Toast.makeText(iv.context, "click image on ${getViewHolder()?.adapterPosition}", Toast.LENGTH_SHORT).show()
            }
        }
    }
}

这里针对 BaseItem 说明一下：

可以拿到 RecycleView 绑定的 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.onItemClickListener = object : OnItemClickListener {
    override fun onItemClick(holder: ItemViewHolder)
          val position = holder.adapterPosition
          val item = holder.item
          val binding = holder.binding
          ...
    }
}

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