QuickBindAdapter

使用Databinding简单快速实现RecyclerView多布局Adapter。只需要用这一个Adapter就够了。

Demo的首页

列表数据是空的时候显示的占位图

GridLayoutManager多种布局展示

StaggeredLayoutManager多种布局展示

在项目中引用

Gradle

Step 1. Add it in your root build.gradle at the end of repositories

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

Step 2. Add the dependency

dependencies {
    implementation 'com.github.Matchas-xiaobin:QuickBindAdapter:3.0.8'
}

API多次大量改动，如果已经在使用老版本了，请注意斟酌是否升级版本：

请在demo中查看具体用法
请注意：必须开启dataBinding功能才能使用这个
请确认在项目模块下添加了如下代码：
android {
    ...
    buildFeatures {
        dataBinding true
    }
    ...
}

在代码中使用：

QuickBindAdapter adapter = new QuickBindAdapter();
adapter.bind()
adapter.setxxx()
...

Kotlin:
1.委托
private val adapter: QuickBindAdapter by lazy {
  QuickBindAdapter().apply{
    bind(,,)
  addClicks(,,)
  ...
  }
}
2.正常使用
val adapter = QuickBinAdapter().apply{
  bind(,,)
  addClicks(,,)
  ...
}

绑定数据类型和布局 有几种布局，就绑定几次，每一种布局要对应一种数据类型

三个参数分别为: 数据类型 , 对应的布局 , 这个数据要设置到的属性
adapter.bind(DataBean.class, R.layout.item_child, BR.data);
adapter.bind(String.class, R.layout.item_group, BR.data);

绑定布局的时候，可以不绑定数据要设置到哪个属性
一般用来穿插一些固定内容不变化的布局，或者想用代码动态配置布局的，建议配合QuickBind一起使用:
adapter.bind(class, layoutId);

多布局注意：
如果使用瀑布流StaggeredGridLayoutManager，假设你的spanCount为3，如果你想实现标题直接占满一行，
则需要将标题的这个实体类实现StaggeredFullSpan接口
并且瀑布流无法像gridLayoutManager那样自定义占几个spanCount

新增空数据时展示全屏占位图;

使用默认的空数据时展示的占位图控制器
adapter.setEmptyView(context);
使用自定义的空数据时展示的占位图控制器，需要继承BasePlaceholder
adapter.setEmptyView(MyEmptyPageView());

展示 加载中 占位图：
adapter.showLoadPage()
adapter.showLoadPage(true)//强制显示 加载中 页面->如果有数据，则清空数据
展示 内容为空 占位图：
adapter.showEmptyPage()
adapter.showEmptyPage(true)//强制显示 空数据 页面->如果有数据，则清空数据
展示 加载错误 占位图：
adapter.showErrorPage()
adapter.showErrorPage(true)//强制显示 加载错误 页面->如果有数据，则清空数据

QuickBind接口，用于只使用Databinding绑定控件，手动写复杂逻辑;

adapter.setQuickBind((binding, itemData, position) -> {
          // binding 是这个item本身，itemData 是这个item的数据，position 是这个item所在列表中的位置
          //如果是多布局，则需要做下判断：
          if (binding instanceof ItemStartBinding) {
              // R.layout.item_start 类型 的item
          }
          //也可以这样：
          if (itemData instanceof String) {
              // String 类型 的item
          }
      });

添加子控件点击事件 对应每一种数据类型的item，添加其子控件的点击事件

adapter.addClicks(ChatListBean.class, R.id.iv_image, R.id.tv_name, R.id.tv_message);

adapter.addClicks(String.class, R.id.tv_name);

点击事件：

adapter.setOnItemClickListener(OnItemClickListener)

adapter.setOnItemChildClickListener(OnItemClickListener)

长按事件：

adapter.setOnItemLongClickListener(OnItemLongClickListener)

adapter.setOnItemChildLongClickListener(OnItemLongClickListener)

获取item数据的api;

  所有数据
  ItemData dataList = adapter.getListData();
  
  单个数据
  Object itemData = adapter.getItemData(position);

设置新数据：

dataList 如果是需要多布局，建议使用ItemData 添加数据。

例如：
    ItemData dataList = new ItemData();
    dataList.add("Group");
    ChatListBean item;
    for (int i = 0; i < 5; i++) {
        item = new ChatListBean();
        item.setId(String.valueOf(i));
        dataList.add(item);
    }
    adapter.setNewData(dataList);
或者你也可以直接：
    adapter.addData("Group")
    ChatListBean item;
    for (int i = 0; i < 5; i++) {
        item = new ChatListBean();
        item.setId(String.valueOf(i));
        adapter.addData(item);
    }

添加数据

添加单个
adapter.addData(object);
添加单个，并且让这个新加的处于可见范围
adapter.addData(object, true);
                                                 
添加多个到列表后面
adapter.addData(arrayList);
添加多个到列表后面，并且让新增的第一个处于可见范围
adapter.addData(arrayList, true);

插入数据到某个位置API;

插入单个数据到指定位置
adapter.insertData(index, itemData);
插入单个数据到指定位置，并且让新插入的处于可见范围
adapter.insertData(index, itemData, true);

从指定位置插入多个数据
adapter.insertDatas(index, arraysData);
从指定位置插入多个数据，并且让新增的第一个处于可见范围
adapter.insertDatas(index, arraysData, true);

移除单个

adapter.remove(position);

替换单个

//替换指定item
adapter.replace(position, object);
//替换指定item，并使其可见
adapter.replace(position, object, true);

移动位置

//移动某个item到另一个位置
movedPositions(fromPosition, toPosition);
//移动某个item到另一个位置，并且让这个item的新位置处于可见
movedPositions(fromPosition, toPosition, true);

加载更多功能;

使用方式：
adapter.setOnLoadMoreListener(@NonNull OnLoadMoreListener onLoadMoreListener);
加载成功:
adapter.loadMoreSuccess();
加载失败:
adapter.loadMoreFailed();
加载完成，没有更多数据了:
adapter.loadMoreSuccessAndNoMore();
主动调用加载更多:
adapter.loadMore();
禁止 触底自动加载更多 关闭后，列表滑动到底后，需要用户点击才会触发加载更多
adapter.setAutoLoadMore(false);
关闭加载更多功能:
adapter.setOnLoadMoreListener(null as (()->Unit)?)
或者(3.2.3版本开始支持):
adapter.removeOnLoadMoreListener()
设置是否开启 当列表数据没有充满rv的情况下，也自动加载更多
 * 如果关闭了 触底自动加载更多，那么这个方法将不在起作用
adapter.enableLoadMoreWhenPageNotFull(true);
  
- 修改 正在加载 文字
- 修改 加载成功 文字
- 修改 加载失败 文字
- 修改 没有更多数据了 文字
使用方式:
DefaultLoadView loadView = new DefaultLoadView(context)
loadView.setOnLoadingText("加载中...")
loadView.setOnWaitLoadingText("点击加载更多")
...
adapter.setLoadView(loadView);
  
DefaultLoadView是内置的默认的。
自定义的布局需要继承BaseLoadView去实现。