RecyclerViewAdapter

It has been written 100% in Kotlin. ❤️ 重新定义RecyclerView Adapter的封装，追求既简单又实用，结合Kotlin的高级特性，优化代码书写方式，真正做到高内聚低耦合

设计图

特点

• DSL写法，简单易用
• 充分考虑ViewHolder复用逻辑，科学防止触碰事件抖动问题
• 抽象合理，高可复用
• 分包依赖，也可以一次性依赖
• 自带Lifecycle生命周期管理
• 动态扩展，耦合降低到了极致
• 部分真泛型，优化泛型问题

库大小

名字	release aar size	其他
Core	32kb	核心库目前包含ListAdapter的实现，最基础且最实用的扩展
DataBinding	22kb	适配DataBinding布局，适用本项目所有Adapter扩展
Sorted	10kb	SortedListAdapter扩展实现
Paging	13kb	PagingListAdapter扩展适配
Diff	6kb	适配DiffUtil，目前适用ListAdapter
FlexBox	9kb	适配FlexBox布局
Selectable	8kb	动态扩展单选、多选、最大可选项功能
Expandable	8kb	动态扩展可展开功能，支持仅单展开或多展开配置
UI	17kb	扩展空布局
Animators	14kb	扩展动画，包括布局初加载动画，添加Item动画，更新Item动画等
Filter	9kb	按照条件过滤列表子项

各个Adapter的优势在哪，如何选择？

名字	优势	劣势	适合做什么
ListAdapter	简单实用，易扩展，ViewHolder复用率高，DSL支持写法优美	对于需要排序的列表处理麻烦性能低	不考虑排序的一般列表
SortedListAdapter	排序超级容易	侵入性高，需要继承SortedModel实现Model层，目前优化为接口，增加了可使用范围	任何需要排序的列表
PagingListAdapter	自带加载状态，后台计算完成后通知刷新，加载效率高	侵入性高，需要Model层继承实现，学习成本高，掌握难度高	适合自动加载分页的列表

各个ViewModel

适用范围

名字	ListAdapter	SortedListAdapter	PagingListAdapter
LayoutViewModel	支持	支持	支持
BindingViewModel	支持	支持	支持

如何选择

名字	功能	优势	其他
LayoutViewModel	加载XML布局	灵活，易懂，易用
BindingViewModel	加载DataBinding布局	省去绑定View的过程，代码逻辑简洁

如何依赖？

提示：按需依赖哦，没必要全部依赖哦

allprojects {
    repositories {
        // 首先项目根目录的build.gradle文件中加入这一行 
        maven { url 'https://jitpack.io' }
    }
}

//一次性依赖，会自动引入全部AAR
implementation 'com.github.ibaozi-cn.RecyclerViewAdapter:1.2.5'

//以下为分包依赖
def adapterVersion = '1.2.5'

//核心库
implementation "com.github.ibaozi-cn.RecyclerViewAdapter:adapter-core:$adapterVersion"

//下面都是可选项

//diffutil 扩展
implementation "com.github.ibaozi-cn.RecyclerViewAdapter:adapter-diff:$adapterVersion"
//data binding扩展
implementation "com.github.ibaozi-cn.RecyclerViewAdapter:adapter-binding:$adapterVersion"
// paging3 扩展
implementation "com.github.ibaozi-cn.RecyclerViewAdapter:adapter-paging:$adapterVersion"
// sortedlist 扩展
implementation "com.github.ibaozi-cn.RecyclerViewAdapter:adapter-sorted:$adapterVersion"
// flexbox 扩展
implementation "com.github.ibaozi-cn.RecyclerViewAdapter:adapter-flex:$adapterVersion"
// UI 扩展
implementation "com.github.ibaozi-cn.RecyclerViewAdapter:adapter-ui:$adapterVersion"
// Selectable 扩展
implementation "com.github.ibaozi-cn.RecyclerViewAdapter:adapter-selectable:$adapterVersion"
// Expandable 扩展
implementation "com.github.ibaozi-cn.RecyclerViewAdapter:adapter-expandable:$adapterVersion"
// Animators 扩展
implementation "com.github.ibaozi-cn.RecyclerViewAdapter:adapter-animators:$adapterVersion"
// Filter 扩展
implementation "com.github.ibaozi-cn.RecyclerViewAdapter:adapter-filter:$adapterVersion"

环境需要

• Kotlin
• JAVA
• AndroidX 抱歉目前按照最新的AndroidX适配的，如有其他需要请私聊我。

怎么用？

看一个最简单的例子 DSL的支持

//xml布局加载示例
fun createViewModelList(max: Int = 10) = (0..max).map { _ ->
    layoutViewModelDsl(R.layout.item_test, ModelTest("title", "subTitle")) {
        onBindViewHolder {
            val model = getModel<ModelTest>()
            getView<TextView>(R.id.tv_title).text = model?.title
            getView<TextView>(R.id.tv_subTitle).text = model?.subTitle
        }
        itemView.setOnClickListener {
            val vm = getViewModel<LayoutViewModel<ModelTest>>()
            //修改Model数据
            vm?.model?.title = "测试更新${Random.nextInt(10000)}"
            //用Adapter更新数据
            getAdapter<ListAdapter>()?.set(adapterPosition, vm)
        }
    }
}
//binding layout布局加载示例
fun createBindingViewModelList(max: Int = 10) = (0..max).map {
    bindingViewModelDsl(
        R.layout.item_binding_layout,
        BR.model,
        ModelTest("title", "bindingViewModelDsl")
    ) {
        itemView.setOnClickListener {
            val viewModel = getViewModel<BindingViewModel<ModelTest>>()
            viewModel?.model?.title = "${java.util.Random().nextInt(100)}"
            getAdapter<ListAdapter>()?.set(adapterPosition, viewModel)
        }
    }
}

//添加到Adapter中，并绑定RecyclerView
listAdapter {
   addAll(createViewModelList(3))
   addAll(createBindingViewModelList(3))
   // 绑定 RecyclerView
   into(rv_list_dsl)
}

开发者

• i校长
  • Jetpack.net.cn
  • 简书
  • 掘金

License

Copyright 2020 Mike Penz

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.