Android开发技巧——使用RecyclerView实现分组列表

有一个多月没写原创博客了，今天来介绍一下使用RecyclerView来实现分组列表。之所以使用RecyclerView，主要原因还是因为项目开发中使用ExpandableListView无法实现设计师所需要的分割线。
本篇内容偏简单，主要是讲如何集成使用。这一使用场景还是相对常见而实用的，较适合初学者进阶。

实现原因及效果

在上一次的项目版本迭代中，有使用到分组列表，但是Android自带的ExpandableListView无法实现设计师的设计图效果。设计图中，每一组，组的标题与每一项，以及每一项之间的分割线都是不同的，所以我便借助于RecyclerView的灵活性来实现，demo运行效果图如下：

如何使用

我已经将实现结果封装为一个库，项目地址为：https://github.com/msdx/group-recycler-adapter ，使用过程有任何疑问或想增加功能，都可以到上面提issue。
接下来只需要两步，即可快速把分组功能集成到项目中。

声明依赖

第一步是声明依赖。
首先确保在项目根目录中的build.gradle中声明了jcenter，如下：

allprojects {
    repositories {
        jcenter()
    }
}

然后在项目中添加如下依赖：

compile 'com.githang:group-recycler-adapter:0.1'

实现分组

示例的完整代码见：https://github.com/msdx/group-recycler-adapter/tree/master/app 。
首先实现分组标题的ViewHolder，以及子项的ViewHolder，然后使用library里的GroupRecyclerAdapter类，创建其实例并实现其中的抽象方法，将数据传入，代码如下：

    RecyclerView recyclerView = findViewById(R.id.recycler_view);
    recyclerView.setLayoutManager(new LinearLayoutManager(this));

    GroupRecyclerAdapter<Team, TeamViewHolder, MemberViewHolder> recyclerAdapter =
            new GroupRecyclerAdapter<Team, TeamViewHolder, MemberViewHolder>(teams) {
                @Override
                protected TeamViewHolder onCreateGroupViewHolder(ViewGroup parent) {
                    return new TeamViewHolder(layoutInflater.inflate(R.layout.item_team_title, parent, false));
                }

                @Override
                protected MemberViewHolder onCreateChildViewHolder(ViewGroup parent) {
                    return new MemberViewHolder(layoutInflater.inflate(R.layout.item_team_member, parent, false));
                }

                @Override
                protected void onBindGroupViewHolder(TeamViewHolder holder, int groupPosition) {
                    holder.update(getGroup(groupPosition));
                }

                @Override
                protected void onBindChildViewHolder(MemberViewHolder holder, int groupPosition, int childPosition) {
                    holder.update(getGroup(groupPosition).members.get(childPosition));
                }

                @Override
                protected int getChildCount(Team group) {
                    return group.members.size();
                }
            };
    recyclerView.setAdapter(recyclerAdapter);

这就完成了分组。这一步还没完，接下来是设置分割线。

分割线

在上面的图中，我们有三种分割线，因此首先需要在drawable中定义这三种分割线，代码如下。
首先是每一组之间的16dp的分割线：
divider_height_16_dp.xml:

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <size android:height="16dp"/>
    <solid android:color="@android:color/transparent"/>
</shape>

然后是标题与子项之间的占满的分割线：
divider_height_1_px.xml:

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <size android:height="1px"/>
    <solid android:color="@color/divider"/>
</shape>

最后是子项之间在左边留白的分割线：
divider_white_header.xml:

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item>
        <shape>
            <size android:height="1px" android:width="16dp"/>
            <solid android:color="@android:color/white"/>
        </shape>
    </item>
    <item>
        <inset xmlns:android="http://schemas.android.com/apk/res/android"
               android:insetLeft="16dp">
            <shape>
                <size android:height="1px"/>
                <solid android:color="@color/divider"/>
            </shape>
        </inset>
    </item>
</layer-list>

然后Java代码中使用library里的另一个类GroupItemDecoration来设置，代码如下：

    GroupItemDecoration decoration = new GroupItemDecoration(recyclerAdapter);
    decoration.setGroupDivider(ResourcesCompat.getDrawable(getResources(), R.drawable.divider_height_16_dp, null));
    decoration.setTitleDivider(ResourcesCompat.getDrawable(getResources(), R.drawable.divider_height_1_px, null));
    decoration.setChildDivider(ResourcesCompat.getDrawable(getResources(), R.drawable.divider_white_header, null));
    recyclerView.addItemDecoration(decoration);

这就设置完成了。运行起来，即如前面效果图所示。

实现过程

本来想讲讲实现过程的，但代码真的是太简单了，相信一看就明，贴代码也无多大意义，可自己参考项目代码：https://github.com/msdx/group-recycler-adapter/tree/master/library/src/main/java/com/githang/groundrecycleradapter 。
整体思路挺简单的：
关于分组的实现思路：在RecyclerView里，无论是多级列表还是一级列表，如果没有展开收缩的功能，那么在实现过程上都是一级列表，只不过组里面的标题是一种View类型，子View里面是另一种View类型。这里就不赘述了。
而分割线的实现思路则是判断View的位置是属于哪一种类型（标题，第一个子View，其他子View），然后把分割线drawable设置进去，最后在绘制的时候获取所设置的drawable画出来。