美文网首页
RecyclerView简化探索,万能适配器Adapter

RecyclerView简化探索,万能适配器Adapter

作者: 小白cz | 来源:发表于2020-08-05 08:17 被阅读0次

    项目链接 GitHub 喜欢请给小星星

    项目目标

    • 提高RecycleView的使用效率
    • 无需写Adapter模板
    • 只需关注数据源 & 视图绑定

    Log

    介绍

    RecyclerView的扩展,扩展了通用Adapter,通用ViewHolder,统一的配置入口,无需再写Adapter,只需关注数据&视图绑定

    无需书写适配器Adapter,通过config函数传入 数据源 & 布局管理器(默认线性布局)

    再通过addType函数添加 数据类 对应 的 class,布局id,视图绑定函数 即可

    多布局情况只需多次调用addType进行添加即可

    支持自定义ViewHolder

    支持ViewBinding,DataBinding,KT-Extensions等工具,通过自定义ViewHolder

    导入 (需Kotlin1.4以上,因使用了SAM接口)

    //root -> build.gradle
    allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }
    
    //project -> build.gradle
    dependencies {
        implementation 'com.github.XiaoBaiCZ:RecyclerViewExtend:0.5.1'
    }
    

    API使用介绍

    /**
     * 配置入口
     * @param data 数据源:任意类型,支持混合类型
     * @param lm 布局管理器:默认线性布局
     * @param config 类型建造者函数,通过 addType 添加 类型对应布局 和 视图绑定函数
     */
    fun RecyclerView.config(
        data: MutableList,
        lm: RecyclerView.LayoutManager = LinearLayoutManager(context),
        config: Builder.()->Unit
    )
    
    
    //Builder类
    //自定义ViewHolder
    /**
     * 添加数据/视图类型函数
     * @param resId 布局ID
     * @param func 视图绑定函数
     */
    fun <D, V> addType(resId: Int, func: BindFunc)
    
    
    //默认ViewHolderX
    /**
     * 添加数据/视图类型函数
     * @param resId 布局ID
     * @param func 视图绑定函数
     */
    fun <D> addType(resId: Int, func: BindFunc)
    

    使用流程

    val data: ArrayList<Any>()      //数据源
    val list: RecyclerView = ...    //RecyclerView 实例
    
    //调用配置函数,传入数据源(可接收多类型,通过Any),默认线性布局
    list.config(data) {
    
        //你的 数据类型 自动跟 布局ID 绑定
        addType<你的数据类型1, 你的自定义ViewHolder1>(你的布局ID1) { d, h, p ->   //d 数据,h ViewHolder, p 下标
            //这里执行视图的数据绑定
        }
        
        //可多次调用addType来进行多布局适配
        addType<你的数据类型2, 你的自定义ViewHolder2>(你的布局ID2) { d, h, p ->   //d 数据,h ViewHolder, p 下标
            //这里执行视图的数据绑定
        }
        
    }
    
    //配置布局管理器
    val lm: GridLayoutManager   //其他布局管理器
    list.config(data, lm) {
        ...
    }
    

    使用示例 (Demo有注释)

    基本使用 Demo (多类型)

    配合ViewBinding使用 Demo

    配合DataBinding使用 Demo

    效果图

    list1.png

    相关文章

      网友评论

          本文标题:RecyclerView简化探索,万能适配器Adapter

          本文链接:https://www.haomeiwen.com/subject/xsiurktx.html