BRV 是比BRVAH更优雅和强大的RecyclerView库
本框架在不影响RecyclerView的任何函数组件使用基础上开发. 本项目也将一直保持维护状态
特点
开发速度No.1无Adapter详细的文档简单的示例低学习成本
功能
快速创建多类型列表 一对一/一对多创建多类型 添加头布局和脚布局 点击(防抖动)/长按事件 分组(展开折叠/递归层次/展开置顶/拖拽/侧滑/多类型/单一展开模式) 悬停 快速创建分割线/间隔(支持官方全部的LayoutManager) 切换模式(例如切换编辑模式) 选择模式(多选/单选/全选/取消全选/反选) 拖拽位置 侧滑删除 下拉刷新(Refresh) | 上拉加载(LoadMore) | 下拉加载(UpFetch), 由SmartRefreshLayout实现 预加载(Preload) 对比数据更新(Diffs) 自动分页加载数据 列表动画/骨骼图动画 列表缺省页, 由StateLayout实现 支持DataBinding/ViewBinding 可添加FlexboxLayoutManager实现Flexbox伸缩布局 可添加Net(基于协程实现自动化的并发网络请求)实现自动化网络请求
框架引入
添加远程仓库根据创建项目的 Android Studio 版本有所不同
Android Studio Arctic Fox以下创建的项目 在项目根目录的 build.gradle 添加仓库
allprojects {
repositories {
// ...
maven { url 'https://jitpack.io' }
}
}
Android Studio Arctic Fox以上创建的项目 在项目根目录的 settings.gradle 添加仓库
dependencyResolutionManagement {
repositories {
// ...
maven { url 'https://jitpack.io' }
}
}
然后在 module 的 build.gradle 添加依赖框架
dependencies {
//...
implementation 'com.github.liangjingkanji:BRV:1.3.77'
}
项目根目录中 gradle.properties 添加
android.enableJetifier=true
android.useAndroidX=true
使用Adapter
创建一个简单的列表
rv.linear().setup {
addType
}.models = getData()
这里出现的BRV关键词即本框架, RV即RecyclerView简称
列表填充数据的三种方式
BRV支持三种方式, 灵活使用; 这里提及的Model就等同于数据类/JavaBean/POJO
1) 函数回调
在onBind函数中填充数据
rv.linear().setup {
addType
onBind {
findView
}
}.models = getData()
2) 实现接口
通过为Model实现接口ItemBind, 实现函数onBind, 在该函数中填充数据; 这种方式在很多框架中被应用, 例如BRVAH, 但是我不推荐这种视图在Model中绑定的方式, 因为Model应当只存储数据和计算逻辑, 不应包含任何UI
class SimpleModel(var name: String = "BRV") : ItemBind {
override fun onBind(holder: BindingAdapter.BindingViewHolder) {
val appName = holder.context.getString(R.string.app_name)
holder.findView
}
}
3) DataBinding
通过DataBinding数据绑定形式自动填充数据, 推荐, 这是代码量最少最灵活的一种方式.
第一步, 启用DataBinding, 在module中的build.gradle文件中
apply plugin: "kotlin-kapt" // kapt插件用于生成dataBinding
android {
/.../
buildFeatures.dataBinding = true
}
第二步, 在Item的布局文件中创建变量, 然后绑定变量到视图控件上
name="m" type="com.drake.brv.sample.model.SimpleModel" /> android:layout_width="match_parent" android:layout_height="wrap_content"> android:id="@+id/item" android:layout_width="match_parent" android:layout_height="100dp" android:layout_margin="16dp" android:background="@drawable/bg_card" android:foreground="?selectableItemBackgroundBorderless"> android:id="@+id/tv_simple" android:text="@{String.valueOf(m.name)}" android:gravity="center" android:layout_width="match_parent" android:layout_height="match_parent" /> 选中行是DataBinding使用方法 第三步, 赋值一个用于自定绑定数据到XML布局的Id(DataBinding基础知识) rv是一个列表. 里面的models是一个list集合, 每个元素对应一个item. dataBinding会根据你赋值的Id自动绑定models中元素到xml中赋值 注意要先在某个布局或Item布局声明 m(m是model的简称)可以是任何其他的名称, model或者sb都可以, 比如你name="data", 那么你就应该使用BR.data BR.data和Android中常见的R.id.data都属于Id常量, 本质上都是Int值. 你可以点击查看BR.m源码 但是一旦声明BRV.model = BR.m你的所有BRV使用的item布局都得使用name="m"来声明数据模型, 否则会无法自动绑定 当然你也可以在onBind里面手动绑定, 但是肯定比自动麻烦, 而且名称本身只是代号我建议都使用m class App : Application() { override fun onCreate() { super.onCreate() // 初始化BindingAdapter的默认绑定ID, 如果不使用DataBinding并不需要初始化 BRV.modelId = BR.m } } 这种方式创建列表无需处理数据 rv.linear().setup { addType }.models = getData() 别看文档中第三种方式复杂, 实际第三种方式代码量最少, 同时最解耦 使用DataBinding可以复制或者引用我的常用自定义属性: DataBindingComponent.kt 如果你想更加了解DataBinding请阅读DataBinding最全使用说明 好了这就是简单的用法,更多详情请查看请前往githup查看相关文档。 好文阅读 大家都在找: Android:android官网下载 Android Studio:androidstudio4.2下载 kotlin:kotlin怎么读
发表评论