Linkage-RecyclerView 是一款基于 MVP 架构开发的二级联动列表控件。它是因 “RxJava 魔法师” 这个项目的需求而存在。
在最初寻遍了 GitHub 也没有找到合适的开源库（高度解耦、可远程依赖）之后，我决心研究参考现有开源项目关于二级联动的逻辑，并自己动手编写一个 高度解耦、轻松配置、可通过 Maven 仓库远程依赖 的真正的第三方库。
Linkage-RecyclerView 的个性化配置十分简单，依托于 MVP 的 “配置解耦” 特性，使用者无需知道内部的实现细节，仅通过实现 Config 类即可完成功能的定制和扩展。
此外，在不设置自定义配置的情况下，Linkage-RecyclerView 最少只需 一行代码即可运行起来。
| RxJava Magician | Eleme Linear | Eleme Grid |
|---|---|---|
 |
 |
 |
Linkage-RecyclerView 的目标是：一行代码即可接入二级联动列表。
除了一键接入而省去 99% 不必要的、复杂的、重复的工作外，你还可以从这个开源项目获得的内容包括：
- 整洁的代码风格和标准的资源命名规范。
- MVP 架构在编写第三方库中的最佳实践：使用者无需了解内部逻辑，通过实现接口即可轻松完成个性化配置。
- 优秀的代码分层和封装**，在不做任何个性化配置的情况下，一行代码即可接入。
- 主体工程基于前沿的、遵循关注点分离的 JetPack MVVM 架构。
- AndroidX 和 Material Design 2 的全面使用。
- ConstraintLayout 约束布局的最佳实践。
- 绝不使用 Dagger，绝不使用奇技淫巧、编写艰深晦涩的代码。
如果你正在思考 如何为项目挑选合适的架构 的话，这个项目值得你参考！
1.在 build.gradle 中添加对该库的依赖。
implementation 'com.kunminx.linkage:linkage-recyclerview:1.8.4'2.依据默认的分组实体类 DefaultGroupedItem 的结构准备一串数据（以下以 JSON 为例）。
// DefaultGroupedItem.ItemInfo 包含三个字段：
String title //（必填）二级选项的标题
String group //（必填）二级选项所在分组的名称，要和对应的一级选项的标题相同
String content //（选填）二级选项的内容[
{
"header": "优惠",
"isHeader": true
},
{
"isHeader": false,
"info": {
"content": "好吃的食物，增肥神器，有求必应",
"group": "优惠",
"title": "全家桶"
}
},
{
"header": "热卖",
"isHeader": true
},
{
"isHeader": false,
"info": {
"content": "爆款热卖，月销超过 999 件",
"group": "热卖",
"title": "烤全翅"
}
}
]
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.在得到数据后，最少只需一行代码即可完成初始化。
List<DefaultGroupedItem> items = gson.fromJson(...);
//一行代码完成初始化
linkage.init(items);注意：如使用 JSON，请在 ProGuard Rules 中为该实体类配置混淆白名单：
-keep class com.kunminx.linkage.bean.** {*;}该库为一级和二级 Adapter 分别准备了 Config 接口（ILevelPrimaryAdapterConfig 和 ILevelSecondaryAdapterConfig），自定义配置时，即是去实现这两个接口，来取代默认的配置。
之所以设置成接口的形式，而非 Builder 的形式，是因为二级联动列表内部的联动逻辑需要指明关键的控件。接口相比 Builder 具有强制性，能够让使用者一目了然必须配置的内容，故而采用接口，通过 MVP 架构的方式来编写该库。
关于个性化配置，具体可以参考我在 ElemeGroupedItem 和 SwitchSampleFragment 中编写的案例：
你需要根据需求，在 BaseGroupedItem 的基础上扩展分组实体类，具体的办法是，编写一个实体类，该实体类须继承于 BaseGroupedItem；该实体类的内部类 ItemInfo 也须继承于 BaseGroupedItem.ItemInfo。
以 Eleme 分组实体类为例，扩充 content、imgUrl、cost 三个字段：
public class ElemeGroupedItem extends BaseGroupedItem<ElemeGroupedItem.ItemInfo> {
public ElemeGroupedItem(boolean isHeader, String header) {
super(isHeader, header);
}
public ElemeGroupedItem(ItemInfo item) { super(item); }
public static class ItemInfo extends BaseGroupedItem.ItemInfo {
private String content;
private String imgUrl;
private String cost;
public ItemInfo(String title, String group, String content) {
super(title, group);
this.content = content;
}
public ItemInfo(String title, String group, String content, String imgUrl) {
this(title, group, content);
this.imgUrl = imgUrl;
}
public ItemInfo(String title, String group, String content, String imgUrl, String cost) {
this(title, group, content, imgUrl);
this.cost = cost;
}
public String getContent() { return content; }
public void setContent(String content) { this.content = content; }
public String getImgUrl() { return imgUrl; }
public void setImgUrl(String imgUrl) { this.imgUrl = imgUrl; }
public String getCost() { return cost; }
public void setCost(String cost) { this.cost = cost; }
}
}注意：如使用 JSON，请在 ProGuard Rules 中为该实体类配置混淆白名单。
在装载数据和实现自定义配置时，泛型框中须指明你编写的实体类，注意 List<ElemeLinkageItem>，以及 new ILevelSecondaryAdapterConfig<ElemeLinkageItem.ItemInfo>() 这两处。
private void initLinkageDatas(LinkageRecyclerView linkage) {
List<ElemeGroupedItem> items = gson.fromJson(...);
linkage.init(items, new ElemePrimaryAdapterConfig(), new ElemeSecondaryAdapterConfig());
}
private class ElemePrimaryAdapterConfig implements ILinkagePrimaryAdapterConfig {
private Context mContext;
public void setContext(Context context) { mContext = context; }
@Override
public int getLayoutId() { return R.layout.adapter_linkage_primary; }
@Override
public int getGroupTitleViewId() { return R.id.tv_group; }
@Override
public int getRootViewId() { return R.id.layout_group; }
@Override
public void onBindViewHolder(LinkagePrimaryViewHolder holder, boolean selected, String title) {
TextView tvTitle = (TextView) holder.mGroupTitle;
tvTitle.setText(title);
tvTitle.setBackgroundColor(mContext.getResources().getColor(
selected ? R.color.colorPurple : R.color.colorWhite));
tvTitle.setTextColor(ContextCompat.getColor(mContext,
selected ? R.color.colorWhite : R.color.colorGray));
}
}
private class ElemeSecondaryAdapterConfig implements
ILinkageSecondaryAdapterConfig<ElemeGroupedItem.ItemInfo> {
private Context mContext;
public void setContext(Context context) { mContext = context; }
@Override
public int getGridLayoutId() { return 0; }
@Override
public int getLinearLayoutId() { return R.layout.adapter_eleme_secondary_linear; }
@Override
public int getHeaderLayoutId() { return R.layout.adapter_linkage_secondary_header; }
@Override
public int getFooterLayoutId() { return 0; }
@Override
public int getHeaderTextViewId() { return R.id.secondary_header; }
@Override
public int getSpanCountOfGridMode() { return SPAN_COUNT_FOR_GRID_MODE; }
@Override
public void onBindViewHolder(LinkageSecondaryViewHolder holder,
BaseGroupedItem<ElemeGroupedItem.ItemInfo> item) {
((TextView) holder.getView(R.id.iv_goods_name)).setText(item.info.getTitle());
holder.getView(R.id.iv_goods_item).setOnClickListener(v -> {
//TODO
});
}
@Override
public void onBindHeaderViewHolder(LinkageSecondaryHeaderViewHolder holder,
BaseGroupedItem<ElemeGroupedItem.ItemInfo> item) {
((TextView) holder.getView(R.id.secondary_header)).setText(item.header);
}
@Override
public void onBindFooterViewHolder(LinkageSecondaryFooterViewHolder holder,
BaseGroupedItem<DefaultGroupedItem.ItemInfo> item) {
//TODO
}
}Email：kunminx@gmail.com
Home：KunMinX 的个人博客
Juejin：KunMinX 在掘金
原本只是提个需求，没有抱太大期望，没想到很快就在评论区收到作者的答复，并在假期内特别准备了这篇文章，在此非常感谢作者对设计的热爱和付出！
本人从接触到从事 Android 开发已有 4 年之久，在经历过近 3 年的架构实践、琢磨 和 反复设计后，标准化的开发模式已完全确立。
现如今，我独立完成一款 29 个页面、34 个 API、350 余项 细节的项目，在自动化脚本的帮助下，只需令人咂舌的 N 天时间。
我承认比起 工程设计，我在 视觉设计 和 交互设计 上毫无天分。我常常为 此处应摆放什么样的控件、控件应呈现什么样式 纠结不已。
网上收集的飞机稿看似都可以，但我没有一个唯一正确的标准来指导、来相信、从而毫无疑问地做出正确的、自己能够笃信的 视觉设计。因而只要谈到 产品设计，我随时处于崩溃的边缘。
然而我没有告诉作者的是，作者在文中对 “为什么” 的阐述，让我重新燃起了学习设计的希望，因为 原来设计也是可以通过思考掌握的，被设计的样式 绝非凭空存在，是有客观的依据和考虑在里边的。
最后，再次感谢作者的分享！
《设计知录》 https://xiaozhuanlan.com/ui-x?rel=kunminx
Copyright 2018-2019 KunMinX
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.