RecyclerView按组分隔

前言

最近项目中需要实现列表按组分隔的效果:根据接收到的推送消息日期进行分组显示,具体分组有“今日”、“昨天”、“更早”。先来看下效果图:


RecyclerView日期按组分隔.gif

思路

  • 列表的实现采用RecyclerView
  • 添加列表项分隔线DividerItemDecoration
  • 列表项日期按组分隔GroupItemDecoration

实现

RecyclerView显示数据集的方法这里就不再赘述了,分隔线直接用的是Android官方的android.support.v7.widget.DividerItemDecoration。下面重点讨论列表项按日期分组显示的效果:

  1. 创建一个类GroupItemDecoration继承自RecyclerView.ItemDecoration
  2. 覆盖getItemOffsets方法,根据ItemDecoration绘制的区域确定列表项绘制的偏移量:
    @Override
    public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
        int position = parent.getChildAdapterPosition(view);
        if (position == 0) {
            // 列表第一项,顶部绘制分隔
            outRect.set(0, mDividerHeight, 0, 0);
        } else if (position > 0) {
            // 列表项属于新的组,顶部绘制分隔
            outRect.set(0, mGroupCallback.getGroupName(position).equals(mGroupCallback.getGroupName(position - 1)) ?
                    0 : mDividerHeight, 0, 0);
        } else {
            // 列表项被删除,不绘制分隔
            outRect.set(0, 0, 0, 0);
        }
    }

列表第一项默认属于一个分组,故需要绘制分隔;其他列表项,如果属于新的分组即与前一项的分组不一样,也需要绘制分隔。由于分隔绘制在列表项顶部,故调用outRect.set(int left, int top, int right, int bottom)时,将第二个参数top设置成分隔的高度即列表项绘制时顶部的偏移量。
注:列表项被删除时,此方法中position可能为-1,此时不绘制分隔。

  1. 覆盖onDrawOver方法,在列表项视图上面绘制分隔:
    @Override
    public void onDrawOver(Canvas c, RecyclerView parent, RecyclerView.State state) {
        if (parent.getLayoutManager() == null) {
            return;
        }

        c.save();
        final int left = parent.getPaddingLeft();
        final int right = parent.getWidth() - parent.getPaddingRight();
        c.clipRect(left, parent.getPaddingTop(), right, parent.getHeight() - parent.getPaddingBottom());

        final int childCount = parent.getChildCount();
        View child;
        int position;
        for (int i = 0; i < childCount; i++) {
            child = parent.getChildAt(i);
            position = parent.getChildAdapterPosition(child);
            if (position == 0) {
                // 列表第一项,顶部绘制分隔
                drawGroup(c, parent, child, position);
            } else if (position > 0) {
                // 第一个可视的列表项或列表项属于新的组,顶部绘制分隔
                if (i == 0 || !mGroupCallback.getGroupName(position).equals(mGroupCallback.getGroupName(position - 1)
                )) {
                    drawGroup(c, parent, child, position);
                }
            }
        }
        c.restore();
    }

由于我们需要实现滑动列表时,分组分隔在顶部悬停的效果,故覆盖onDrawOver方法;此方法是在列表项视图绘制完之后调用,因而能实现分隔在列表项上面的效果。同样的:列表第一项默认属于一个分组,故需要绘制分隔;其他列表项,如果属于新的分组即与前一项的分组不一样,也需要绘制分隔。不一样的是:当滑动列表时,分组分隔需要顶部悬浮,故第一个可视的列表项也需要绘制分隔。下面具体看一下绘制分组的方法:

    /**
     * 绘制分组
     *
     * @param c        用于绘制分组信息
     * @param parent   需要绘制分组的列表
     * @param child    需要绘制分组的列表项
     * @param position 列表项位置
     */
    private void drawGroup(Canvas c, RecyclerView parent, View child, int position) {
        parent.getDecoratedBoundsWithMargins(child, mBounds);

        // 头部悬停
        int top = Math.max(mBounds.top + Math.round(ViewCompat.getTranslationY(child)), parent.getPaddingTop());
        int bottom = top + mDividerHeight;
        int itemCount = parent.getAdapter().getItemCount();
        if (bottom > mBounds.bottom && position + 1 < itemCount && !mGroupCallback.getGroupName(position +
                1).equals(mGroupCallback.getGroupName(position))) {
            // 新分组即将滑动到头部的粘性效果
            bottom = mBounds.bottom;
            top = bottom - mDividerHeight;
        }

        // 绘制分组背景
        mPaint.setColor(mBackgroundColor);
        c.drawRect(mBounds.left, top, mBounds.right, bottom, mPaint);

        // 绘制分组名称
        String groupName = mGroupCallback.getGroupName(position);
        mPaint.getTextBounds(groupName, 0, groupName.length(), mBounds);
        mPaint.setColor(mTextColor);
        c.drawText(groupName, mTextPaddingLeft, bottom - (mDividerHeight - mBounds.height()) / 2, mPaint);
    }

要想实现头部悬停的效果,分隔绘制的顶部不能小于列表顶部,否则将移出屏幕。同时要实现粘性效果,则当分组中最后一项即将移出屏幕时,需要调整分隔绘制的区域,使其与列表项一起移出屏幕。

  1. 初始化RecyclerView之后,添加分组分隔:
        mRecyclerView.addItemDecoration(new GroupItemDecoration(this, new GroupItemDecoration.GroupCallback() {
            @Override
            public String getGroupName(int position) {
                // TODO: 返回列表项对应的分组名称
            }
        }));

初始化GroupItemDecoration时需要传递GroupItemDecoration.GroupCallback参数,此回调接口定义如下:

    /**
     * 分组回调
     */
    public interface GroupCallback {
        /**
         * 获取分组名称
         *
         * @param position 列表项位置
         * @return 分组名称
         */
        String getGroupName(int position);
    }

小结

利用RecyclerView.ItemDecoration实现分组的效果比较简洁,且能够复用,推荐大家使用!
本人是第一次写技术文章,希望能帮到大家。如果有错误或疑问的地方,欢迎指出,谢谢!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,937评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,503评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,712评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,668评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,677评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,601评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,975评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,637评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,881评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,621评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,710评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,387评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,971评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,947评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,189评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,805评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,449评论 2 342

推荐阅读更多精彩内容