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(R.layout.item_simple)

}.models = getData()

这里出现的BRV关键词即本框架, RV即RecyclerView简称

列表填充数据的三种方式

BRV支持三种方式, 灵活使用; 这里提及的Model就等同于数据类/JavaBean/POJO

1) 函数回调

在onBind函数中填充数据

rv.linear().setup {

addType(R.layout.item_simple)

onBind {

findView(R.id.tv_simple).text = getModel().name

}

}.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(R.id.tv_simple).text = appName + itemPosition

}

}

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布局声明布局中的变量name="m", BR.m才能被生成导包注意导入你所在module的BR, 这样所有使用该Id来声明数据模型的布局都会被BRV自动绑定数据 

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(R.layout.item_simple)

}.models = getData()

别看文档中第三种方式复杂, 实际第三种方式代码量最少, 同时最解耦

使用DataBinding可以复制或者引用我的常用自定义属性: DataBindingComponent.kt 如果你想更加了解DataBinding请阅读DataBinding最全使用说明

 好了这就是简单的用法,更多详情请查看请前往githup查看相关文档。

好文阅读

评论可见,请评论后查看内容,谢谢!!!
 您阅读本篇文章共花了: