Skip to content

1.简单使用

KunMinX edited this page May 31, 2022 · 2 revisions

1.在 build.gradle 添加依赖。

implementation 'com.kunminx.linkage:linkage-recyclerview:2.7.0'

提示:鉴于 Jcenter 的关闭,我们已将仓库迁移至 Maven Central,请自行在根目录 build.gradle 添加 mavenCentral()

2.依据默认分组实体类 DefaultGroupedItem 结构准备一串数据。

// DefaultGroupedItem.ItemInfo 包含三个字段:
String title //(必填)二级选项的标题
String group //(必填)二级选项所在分组的名称,要和对应的一级选项的标题相同
String content //(选填)二级选项的内容
List<TestGroupedItem> list = new ArrayList<>();

//添加第 0 条记录:header 0
list.add(new TestGroupedItem("优惠", true));

//添加第 1 条记录:info 1
TestGroupedItem.ItemInfo info1 = new TestGroupedItem.ItemInfo();
info1.setContent("好吃的食物,增肥神器,有求必应");
info1.setGroup("优惠");
info1.setTitle("全家桶");
list.add(new TestGroupedItem(info1, false));

//添加第 2 条记录:header 2
list.add(new TestGroupedItem("优惠", true));

//添加第 3 条记录:info 3
TestGroupedItem.ItemInfo info3 =
  new TestGroupedItem.ItemInfo("爆款热卖,月销超过 999 件", "热卖", "烤全翅");
list.add(new TestGroupedItem(info3, false));

3.在布局中引入 LinkageRecyclerView 。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <com.kunminx.linkage.LinkageRecyclerView
        android:id="@+id/linkage"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</LinearLayout>

4.在得到数据后,最少只需一行代码即可完成初始化。

linkage.init(items);

温馨提示:

1.在实际的项目开发中,我们的做法通常是,从后端拿到和解析 JSON 数据,并对得到的数据进行遍历。在遍历过程中,我们实例化并装载本库的实体类对象到列表中,从而获得本库所能使用的列表数据。

2.注意:如使用 JSON,请在 ProGuard Rules 中为该实体类配置混淆白名单:

-keep class com.kunminx.linkage.bean.** {*;}
Clone this wiki locally